Connect your personal Telegram account to Claude, ChatGPT, Cursor and any other Model Context Protocol client. Your assistant can catch up on unread chats, search your message history, read channels and forum topics, open media, and reply or react — with outgoing messages shown to you before they are sent.
Built on Telegram's MTProto API with GramJS. Open source under the MIT license.
| mcp-telegram | mcp-telegram-cloud | |
|---|---|---|
| What | The MCP server: 180+ tools, CLI, serve daemon |
Hosted multi-user version with OAuth and QR login |
| Run it | npx @overpod/mcp-telegram, Docker or a prebuilt binary |
Use mcp-telegram.com or self-host with Docker |
| Best for | Claude Code, Claude Desktop, Cursor, Codex and other local clients | claude.ai, ChatGPT and other remote clients |
| Docs | mcp-telegram.github.io/mcp-telegram (English, Russian, Chinese) | mcp-telegram.com/docs |
The hosted version is listed in the ChatGPT and Claude directories under the name Chatroost (both listings are in progress).
- Roadmap: the public roadmap board. Look for
good first issueandhelp wanted. - Questions and ideas: Discussions.
- Bugs: mcp-telegram issues for tools and the CLI, mcp-telegram-cloud issues for the hosted service.
- Security: report privately, see SECURITY.md.
You can write in any language.
mcp-telegram is an independent project and is not affiliated with Telegram. Contact: @overpod on Telegram.