Labsco
MCP SERVER

MCP Telegram

by dryeab

Read, search, send and edit Telegram messages as yourself, over MTProto rather than a bot API.

Team Chat Platforms
Summary
Your own Telegram account, scriptable in a sentence.

Acting as the user rather than a bot is the point and the cost: it reaches everything you can reach, which also means a careless instruction sends a real message from you. Run one instance per session file - two processes sharing one session produce database-locked errors.

What it is

A Telegram client built on Telethon and exposed over MCP. It signs in with your own account, so it reaches the chats you are in - not only the ones a bot has been added to.

What you get
  • Send text or files to any user, group or channel
  • Edit the content of a message you already sent, and delete one or several
  • Pull message history with filtering
  • Find users, groups and channels by name or username
  • Open a specific message from a Telegram link
  • Read and set the draft on any chat
  • Download photos, video and documents out of messages
Requirements

Python 3.10 or higher and uv. Install with uv tool install mcp-telegram, then run mcp-telegram login once - it asks for the API ID and API hash from my.telegram.org/apps, your phone number, the code Telegram sends, and your two-factor password if you have one. The client config passes API_ID and API_HASH and starts the server with the start argument.

Setup effort

One command plus a key — uv tool install mcp-telegram, then supply credentials