Telegram MCP: Documentation
Updated:
Connection
Repo: github.com/chigwell/telegram-mcp (256★). Install: git clone + pip install -r requirements.txt, run as an stdio server or in HTTP/SSE mode. Auth: TELEGRAM_API_ID + TELEGRAM_API_HASH (from my.telegram.org) plus an interactive phone-number login on first run — Telethon's session file is saved locally and reused afterward.
Tools
80+ tools across Telegram entities: chats and groups (list, search, members), messages (send text/media, read history, keyword search, forward), contacts (list, search, add), media (send/download files and photos), profile (name, avatar, privacy status).
Agent flow
"Find messages about the bug in the Product group over the last week", "send the report photo to a contact in a DM", "read the last 50 messages in the chat and summarize them".
Pricing
Free and open source; the Telegram API is free for personal use (get API_ID/API_HASH at my.telegram.org).
Note
A community project (chigwell), not an official Telegram product — it operates through a real account (MTProto), not the Bot API. The session file grants full account access — treat it like a private key.