telegram-mcp
Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.
telegram-mcp is an MCP server that integrates Telegram with AI assistants like Claude Desktop and Cursor using the Telethon library. It provides over 80 tools for managing Telegram accounts, reading and sending messages, managing groups and channels, handling media files, and transcribing voice messages. Developers connect it to MCP-compatible clients to give AI agents full programmatic access to Telegram chats, contacts, and media, enabling automated conversation management and content operations.
Key Features
Use Cases
- 01Read chat history and send AI-generated replies in Telegram conversations
- 02Automate group and channel management tasks like invites, bans, and admin assignments
- 03Transcribe voice messages automatically and search conversation transcripts
- 04Download media from chats or upload files to contacts and groups
- 05Monitor incoming messages across multiple Telegram accounts from one AI assistant
- 06Manage Telegram folders, drafts, and privacy settings programmatically
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
telegram-mcp — FAQ
What is telegram-mcp?+
telegram-mcp is an MCP server that connects Telegram to AI assistants via the Model Context Protocol, exposing over 80 tools for reading chats, sending messages, managing groups, handling media, and transcribing voice messages using the Telethon library.
How do I install telegram-mcp?+
Clone the repository, run uv sync to install dependencies, generate a Telegram session string with uv run session_string_generator.py, then configure your MCP client (Claude Desktop, Cursor, etc.) to run uv --directory /path/to/telegram-mcp run main.py with your API credentials in the env block.
Which MCP clients work with telegram-mcp?+
telegram-mcp works with Claude Desktop, Cursor, Claude Code, Codex, and any other MCP-compatible client supporting stdio, streamable HTTP, or SSE transports.
What API keys and prerequisites are required?+
You need a Telegram API ID and API hash from my.telegram.org/apps, a generated Telegram session string, and optionally a Groq API key if you want voice transcription via Groq Whisper (Telegram Premium transcription is also available).
Is telegram-mcp free?+
Yes, telegram-mcp is open source under Apache 2.0 license. Voice transcription via Groq requires a Groq API key (free tier available); native Telegram transcription requires Telegram Premium on your account.
Can I restrict telegram-mcp to read-only access?+
Yes, set TELEGRAM_EXPOSED_TOOLS=read-only to expose only tools with readOnlyHint=True, or use read-only+send_message,reply_to_message to allow specific write tools on top of the read-only baseline.
How do I install telegram-mcp?+
Open the source repository on GitHub and follow its README. telegram-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is telegram-mcp free?+
telegram-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.