Telegram MCP Server
Telegram messaging and media management directly from your AI agent interface.
Data last scanned today · Reviewed today
Overview
Telegram MCP Server bridges Large Language Models with the Telegram platform using the MTProto protocol. Powered by Telethon, it equips AI agents with the ability to perform messaging tasks such as sending, editing, and deleting messages. Users can also manage chat drafts and search through their conversation history. Beyond basic text interaction, this server includes capabilities for handling media files, allowing AI agents to interact with media attachments. The tool is installed via uv and requires a manual authentication flow through the command line to link your Telegram account.
Our verdict
With a security score of 26/100, this server is classified as high-risk. This rating is primarily due to the repository being community-maintained rather than official and a significant lack of maintenance activity, with the last commit occurring over 400 days ago. Given the potential for account restrictions mentioned in the documentation, this tool should only be used by developers who are comfortable auditing the codebase themselves.
- Uses zero direct dependencies to minimize supply-chain surface area.
- Licensed under the permissive MIT license.
- Provides comprehensive README documentation for setup and usage.
- Repository has not received a commit in 412 days.
- Maintained by a single contributor, posing a bus-factor risk.
- Lacks external security or editorial review of its implementation.
Tools
| Tool | Description | Risk |
|---|---|---|
| send_message | Send text messages or files to any user, group, or channel | medium |
| edit_message | Modify content of previously sent messages | medium |
| delete_message | Remove one or multiple messages | high |
| get_messages | Retrieve message history with advanced filtering options | low |
| search_dialogs | Find users, groups, and channels by name or username | low |
| message_from_link | Access specific messages using Telegram links | low |
| get_draft | View current message draft for any chat | low |
| set_draft | Create or clear message drafts | medium |
| media_download | Download photos, videos, and documents from messages | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the system prerequisites for running this server?
You must have Python 3.10 or higher and the uv package manager installed.
›Where do I obtain the necessary API credentials?
You need to obtain an API ID and an API Hash by registering your application at my.telegram.org/apps.
›How do I clear my credentials if I need to log out?
You can use the command mcp-telegram logout to end your current session, or mcp-telegram clear-session to remove all stored session data.
›What should I do if my MCP client cannot execute the mcp-telegram command?
If the client cannot find the command, use the full path to the executable by running which or where to locate it, and replace the command value in your configuration file with that full path.
›Are there any usage warnings I should be aware of?
The developers advise users to read and understand Telegram's Terms of Service before use, as misuse of the tool may result in account restrictions.
Badge
Maintain this server? Add the live badge to your README.