MCP TelegramMCP TelegramRead messages, search chats, send replies, react to posts — all from Claude.ai or ChatGPT. Connect in 30 seconds with a QR code.
Read your chats, send replies, react to posts — your account, your control
Browse messages from any chat with date filtering and pagination
Full-text search across chats, messages, contacts and channels
Get chat info, member lists, unread counts and detailed metadata
Download and view photos inline directly in AI conversations
Access your contacts list and group/channel member lists
Reply to messages, send photos, add reactions and update drafts
Connect several Telegram accounts to one AI assistant and switch between them with one command
Read, post, edit and review who viewed your stories — for yourself and channels you run
Send documents, photos, voice notes and albums from your computer or a URL
Real prompts you can use right after connecting
"Summarize my unread messages and highlight anything urgent"
"Find messages about the project deadline in our work chat"
"List all links shared in the design channel this week"
"Who are the most active members in our community group?"
"Give me a summary of what happened in the team chat today"
"Show me the photos sent in the family chat yesterday"
Three steps, 30 seconds, no API keys needed
Click "Connect" in Claude.ai or add as app in ChatGPT
Open Telegram → Settings → Devices → Link Desktop Device → Scan
Ask AI to read your chats, search messages, or summarize conversations
Common questions about security and privacy
Yes. Your account connects via QR code — the same flow Telegram Web and Desktop use, so you stay in control. Read-only tools work out of the box. Write tools (send a reply, react, save a draft) are available so the AI can act on your behalf when you ask it to. Irreversible actions (delete, edit, kick) are off by default and require an explicit opt-in in your settings, with a daily quota and an audit log. You can disconnect or revoke the session at any time from Telegram → Settings → Devices.
We don't store your messages. Each tool call fetches data directly from Telegram's API and returns it to the AI assistant. Your Telegram session key is stored on our server so the connector can keep working between requests, and is deleted whenever your session ends (see the next answer for the exact timing). Storage details and hardening guidance are in our SECURITY.md.
It uses MTProto — the same protocol Telegram's official apps use. You authenticate via QR code, just like linking a new device. From Telegram's perspective, it's another logged-in client.
If you explicitly remove the connector in Claude.ai or ChatGPT, the server logs the Telegram session out and deletes the session key right away. If you just close the AI app without revoking, the in-memory client is dropped immediately and the stored session key is kept briefly so you can resume seamlessly; if you don't reconnect within a short idle window (a few minutes), the server logs out and deletes the key automatically. You can also force a full revoke at any time from Telegram → Settings → Devices.
Yes. After connecting your first account, ask the assistant to add another with the `telegram-accounts-add` tool — you'll get a one-time URL with a QR code for the second account. Use `telegram-accounts-switch` to change which account the next tool call will use. No disconnect/reconnect needed.
Yes. Add it as an app in ChatGPT Settings → Apps (Developer Mode). Use the URL https://mcp-telegram.com/mcp with OAuth authentication. Works on Plus, Pro, Team, and Enterprise plans.
Yes. The server is fully open-source under the MIT license at github.com/mcp-telegram/mcp-telegram-cloud.