Skip to main content
MCP server CX Codex

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 GitHub

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

Similar MCP servers

All MCP servers for Telegram bots →

Project sponsors

Companies that keep this analytics open