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.
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.
- 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
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.
One command plus a key — uv tool install mcp-telegram, then supply credentials
