Telegram
Free通过 Telethon 集成 Telegram，支持分页读取聊天、检索和发送消息。
FreeFree tier
Inputs: text, image, fileOutputs: text, image, file
About Telegram
A Telegram integration for Claude, Cursor, and other MCP-compatible clients. It exposes Telegram account, chat, message, contact, media, folder, and admin operations through the Model Context Protocol using Telethon. The server includes 80+ MCP tools grouped into accounts, chats/groups, messages, contacts, media, profile/privacy, and folders/drafts. All tool results are sanitized and returned as structured JSON.
Key Features
Manage multiple Telegram accounts and route tool calls by account label
List chats, inspect metadata, create groups/channels, join/leave, invite users, manage admins, bans, permissions, topics, invite links, read receipts, and message links
Send, schedule, edit, delete, forward, pin, unpin, mark read, reply, search messages; create polls; manage reactions; and press inline buttons
Manage contacts: list, search, add, delete, block, unblock, import, export, inspect direct chats, and find recent interactions
Send files, download media, upload files, send voice notes, stickers, GIFs, and inspect message media
Get and update account info, set/delete profile photos, inspect privacy settings, get user info/status, and manage bot commands
List, create, update, reorder, and delete Telegram folders; save, list, and clear drafts
All results are sanitized and returned as structured JSON for safe processing
Pros & Cons
Pros
- Open source and completely free
- Extensive 80+ MCP tools covering almost all Telegram operations
- Integrates with popular MCP clients like Claude Desktop and Cursor
- Multi-account support with account labels
- Sanitized outputs enhance security
- Active development with 1.3k stars on GitHub
Cons
- Requires creating Telegram API credentials (potential security risk if mishandled)
- Cannot be installed via pip due to PyPI package name conflict; must clone the repo
- Requires Python 3.10+ and the uv tool for setup
- Session string generation adds extra setup complexity
Best For
Automate Telegram messaging and group managementAnalyze chat history and send responses via AI assistants like ClaudeBuild chatbots or personal assistants integrated with TelegramManage large Telegram groups with automated moderationBackup and export Telegram contacts and media
FAQ
How do I get started?
Clone the GitHub repository, run 'uv sync', generate a session string using the provided 'session_string_generator.py' script, and configure your MCP client with the required credentials.
What MCP clients are supported?
The server works with any MCP-compatible client, including Claude Desktop, Cursor, and other hosts that support the Model Context Protocol.
Can I use multiple Telegram accounts?
Yes, the server supports multiple accounts with account labels that allow you to route tool calls to specific accounts.
Is this tool secure?
The repository sanitizes outputs and provides a security script. You should keep your Telegram API credentials and session string confidential to prevent unauthorized access.
Why can't I install via pip?
The package name 'telegram-mcp' on PyPI is owned by a different project. To avoid credential exposure, install by cloning the repository directly from GitHub.