Unofficial Telegram connector · MCP

Your authorized Telegram account,
inside Claude

Summarize chats, search messages and draft replies in your own Telegram account — just by asking Claude.

https://tg.mctl.ai/mcp

Open Claude connectors ↗

Claude web · desktop · mobile · Code ChatGPT by URL Read-only by default Open source

65,056tool calls, last 90 days

169accounts

91active last 30 days

106connected sessions

live · updated 01:51 UTC

MCTL Assistant is an unofficial third-party connector using the Telegram API. Not affiliated with Telegram, Anthropic or OpenAI.

What you can ask

Summarize

“What did I miss in my chats today?”

Draft & review

“Draft a polite reply to Anna.”

“Find the address Max sent last week.”

Triage

“Which chats still need my reply?”

Translate

“Translate the last messages in this group.”

“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

03Connect, sign in with Telegram, pick Read only or Read + send

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

03Create as a plugin and sign in with Telegram

Other clients

not yet tested

// 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.

Security model Privacy policy Developer reference

Keep the session on your machine Beta With Local Bridge, tg.mctl.ai only relays calls to a daemon you run.

Quick start →

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.

Your authorized Telegram account,inside Claude