A Model Context Protocol (MCP) server for interacting with Telegram using mtcute.
telegram-mcp is an MCP project maintained in the zhigang1992/telegram-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for interacting with Telegram using mtcute”. Read the project documentation for the complete scope.
The project provides a local client configuration using /path/to/telegram-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares API_ID, API_HASH, TELEGRAM_STORAGE_PATH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| messages_sendText | Send a text message to a chat |
| chatId | required): Chat/User ID or username |
| text | required): Message text to send |
| replyToMessageId | Optional message ID to reply to |
| messages_getHistory | Get message history from a chat |
| limit | Maximum dialogs (default: 50) |
| offsetId | Message ID for pagination |
| messages_search | Search for messages |
| query | required): Search query |
| messages_getRecent | Get recent messages from all chats |
| messagesPerChat | Messages per chat (default: 10) |
| wait_for_reply | Wait for the next message in a chat |
| timeoutSeconds | Timeout in seconds (default: 60, max: 300) |
| status_getCurrent | Get the current emoji status for a peer |
| peerId | Target peer, defaults to self |
| status_setEmoji | Set or clear an emoji status |
| emojiId | Custom emoji document ID, required unless clear=true |
| isCollectible | Set true when emojiId is a collectible ID |
| until | Optional ISO-8601 timestamp or Unix timestamp string |
| clear | Clear the current status instead of setting one |
| status_listAvailable | List available default emoji-status IDs |
| scope | self or channel (default: self) |
| status_listCollectibles | List owned collectible IDs usable as self emoji statuses |
| owner | Peer to inspect, defaults to self |
| dialogs_list | List all dialogs |
| filter | Filter options (onlyUsers, onlyGroups, onlyChannels) |
| dialogs_getInfo | Get detailed dialog information |
{
"mcpServers": {
"telegram": {
"command": "/path/to/telegram-mcp",
"env": {
"API_ID": "your_api_id",
"API_HASH": "your_api_hash",
"TELEGRAM_STORAGE_PATH": "/absolute/path/from/initial/setup"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| API_ID | Declared in the maintainer’s client configuration. | Check documentation |
| API_HASH | Declared in the maintainer’s client configuration. | Check documentation |
| TELEGRAM_STORAGE_PATH | Declared in the maintainer’s client configuration. | Check documentation |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Due diligence on Canadian companies: registry status, sanctions and risk signals via Apify.
Give your AI agent a phone. Place outbound calls to US businesses to ask, book, or confirm.
Global stock research, ML forecasts, valuation signals, screeners & portfolio tracking in Claude
DeepADB — full-featured Android Debug Bridge MCP server. 204 tools across 45 modules for device inspection from UI to baseband.