MCTL for Telegram
MCTL for Telegram 允许用户在获得明确授权后,通过ChatGPT访问和管理自己的Telegram账户。它支持读取最近聊天记录、总结消息、起草回复、默认仅预览发送、确认置顶操作、审计审查以及账户断开/删除控制。它不是Telegram官方应用或Telegram API合作伙伴,Telegram消息内容被视为不可信的用户生成数据。
文档
What you can ask
Summarize
“What did I miss in my chats today?”
Draft & review
“Draft a polite reply to Anna.”
Search
“Find the address Max sent last week.”
Triage
“Which chats still need my reply?”
Translate
“Translate the last messages in this group.”
Pin
“Pin the meeting link in Team chat.”
Nothing is sent until you turn sending on. More prompts to try
How it works
Claudeyou ask
OAuth
MCTLencrypted session
MTProto
Telegramyour account
Connect in a minute
Claude
01Open Customize → Connectors → Add custom connector
02Name MCTL Assistant URL https://tg.mctl.ai/mcp
Works on mobile once added. Team & Enterprise: an Owner adds it once in Organization settings.
Claude Code
claude mcp add --transport http --scope user mctl https://tg.mctl.ai/mcp
Then run /mcp inside Claude Code to sign in.
ChatGPT
01Open Plugins → Personal → Add custom MCP server
02Server URL https://tg.mctl.ai/mcp, authentication OAuth
Other clients
// Cursor · ~/.cursor/mcp.json
{ "mcpServers": { "mctl": { "url": "https://tg.mctl.ai/mcp" } } }
// VS Code · .vscode/mcp.json
{ "servers": { "mctl": { "type": "http", "url": "https://tg.mctl.ai/mcp" } } }
Cursor sign-in may fail today: cursor:// redirects are refused. Details in /docs.
Your data
Stored, encrypted Telegram session AES-256-GCM, with a key derived per user from one service key. Audit metadata (tool name, redacted peer, status) is stored without this encryption. When Communication Agent is enabled, relevant message and action content is also stored encrypted at rest; see the retention details in /privacy.
Not stored in logs or audit history Message text, phone numbers, 2FA passwords, tokens
You control Disconnect or delete your account at any time Disconnect on the manage page or with MCP tools. Delete with an MCP tool or the API.
Keep the session on your machine Beta With Local Bridge, tg.mctl.ai only relays calls to a daemon you run.
Questions
Is this an official Telegram app?
No. It is an independent, unofficial connector using the Telegram API, not affiliated with or endorsed by Telegram, Anthropic or OpenAI. It works only on the account you connect, and you remain responsible for following Telegram's terms.
Can it send messages on my behalf?
Only if you choose Read + send. In read-only mode send_message and send_media return a preview and nothing is delivered, and the other write tools refuse with an error. You can change this any time on the manage page.
What does my AI assistant see?
Your prompts, tool arguments and the results this server returns. The assistant's provider handles that traffic under its own policies. Listener-enabled Communication Agent accounts additionally store encrypted message and action content as described in /privacy.
How do I revoke access?
Remove the connector in Claude, disconnect on the manage page, or end the session in Telegram: Settings → Devices.
Which assistants does it work with?
Claude on web, desktop, mobile and Claude Code; ChatGPT by URL. Other MCP clients (Cursor, VS Code, Windsurf) may work but are not yet tested.
Is it open source?
Yes — github.com/mctlhq/mctl-telegram. Audit the code, self-host or contribute.