Happy slice of mcp pizzaMCP.pizza
mcp-telegram

mcp-telegram

MCP.Pizza Chef: dryeab

Signing in with your own Telegram account — phone number, code and all — gives an assistant the same reach you have: messages and files to any person, group or channel, edits and deletions of what it sent, chat history on demand, finding people and groups by name, saving drafts, and pulling photos or videos out of a conversation. That is full access to a personal account, so set it up deliberately. Telegram's own rules still apply, and the code has not changed since June 2025.

Unmaintained · no code changes since June 2025, bugs not followed up
Communication

Use This MCP server To

Find the message where someone sent me an address Send a file to a group chat without opening the app Catch up on what a busy channel said today Save photos a friend sent me onto my computer Leave a reply waiting as a draft for me to check Delete a message I fired off to the wrong chat

README

MCP Telegram Logo

Enable LLMs to control your Telegram

GitHub stars PyPI version Twitter Follow

Connect Large Language Models to Telegram via the Model Context Protocol (MCP).

Built with Telethon, this server allows AI agents to interact with Telegram, enabling features like sending/editing/deleting messages, searching chats, managing drafts, downloading media, and more using the MTProto.

Table of Contents

🚀 Getting Started

Prerequisites

Installation

Install the mcp-telegram CLI tool:

uv tool install mcp-telegram

mcp-telegram FAQ

Is this still being maintained?
It has had no code changes since June 2025. The published package still installs, but bugs and Telegram-side changes are not being followed up.
Do I need a key or an account?
Yes, more than most. You register for a free ID and secret on Telegram's own developer page, then sign in from a terminal with your phone number, the code Telegram sends you, and your two-factor password if you use one.
Is it safe to hand my Telegram account to an assistant?
Be deliberate about it. It can send, edit and delete on your behalf, and there is no look-but-do-not-touch mode. The project itself warns that misuse can get a Telegram account restricted.
Can I use this to dig up an old message?
Yes. It can search your chats by name, pull back history with filters, and open a specific message from a Telegram link you paste in.
Which apps does it work in?
Claude Desktop and Cursor are the two documented, and other MCP-capable assistants take the same settings block.
How hard is the setup?
Fiddly rather than impossible. You install a command-line tool, run a sign-in that asks you questions, then paste a short settings block into your assistant. Expect a terminal to be involved throughout.