Telethon Plus — Claude Code MCP server for Telegram
Telethon Plus is an MCP server for Claude Code that lets an agent control a Telegram account through MCP or HTTP. Requests run as the account logged into Telethon.
GPL-2.0 ★ 5 updated 2026-11-10
Open on GitHubWhat Telethon Plus does
Telethon Plus routes MCP and HTTP API requests through a Telethon client to Telegram. Both interfaces share one server, and an agent connects through the /mcp/ endpoint.
Running it requires Docker, TELETHON_API_ID and TELETHON_API_HASH from Telegram, plus a session string created during phone-based login. Set TELETHON_AUTH_KEY to restrict access; anyone who can reach the port can access the account without it. The session string also grants full account access.
What it helps with
- control a Telegram account from an AI agent
- send requests to Telegram through an HTTP API
- connect an agent to Telegram over MCP
Example prompts for the agent
- Show me the data available in my Telegram account.
- Send a Telegram message from my account.
- Connect to Telegram through the Telethon Plus server.
How to install Telethon Plus
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Telethon Plus
How do I install Telethon Plus for Claude Code?
Get API_ID and API_HASH from Telegram, then log in with docker run --rm -it -e TELETHON_API_ID=123456 -e TELETHON_API_HASH=your-api-hash psyb0t/telethon-plus login. Start the container with the resulting session string, then configure Claude Code to connect to the server.
What does Telethon Plus do?
It exposes a Telegram userbot through an HTTP API and an MCP endpoint. Requests use the permissions of the logged-in Telegram account.
What does Telethon Plus need to run?
It needs Docker, TELETHON_API_ID, TELETHON_API_HASH, and a Telethon session string. Use TELETHON_AUTH_KEY to protect access.