telegram-mcp
A local MCP server, distributed as a compiled binary, that connects an AI client to your own Telegram account through the Telegram API.
What it does
A local MCP server, distributed as a compiled binary, that connects an AI client to your own Telegram account through the Telegram API. You get an API id and hash from my.telegram.org and run an auth command (with your 2FA password if set) before use. It offers five tools: show the current account, list dialogs with an unread filter, mark a dialog as read, read messages from a dialog, and save a draft message in a dialog. Install options are Homebrew, npx, release downloads or building from source. The README warns that misuse can get an account suspended.
Capabilities
- List Telegram dialogs with unread filter
- Read messages from a dialog
- Mark dialogs as read
- Save draft replies
Install
- Run this to add it to Any client:
brew install chaindead/tap/telegram-mcp
- Add this to Any client's configuration:
{"mcpServers":{"telegram":{"command":"npx","args":["-y","@chaindead/telegram-mcp"],"env":{"TG_APP_ID":"<your-api-id>","TG_API_HASH":"<your-api-hash>"}}}}
From the project's documentation · Add to a config file with the config builder
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Telegram | |
| Publisher | chaindead | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | macOS, Linux, Windows | source |
| AI clients | Claude Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit May 28, 2026350 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/servers/chaindead-telegram-mcp/)
Sources
- README (README.md)github.com/chaindead/telegram-mcp · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, Platforms, PublisherNov 12, 2026
- Licence file (LICENSE)github.com/chaindead/telegram-mcp · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/chaindead/telegram-mcp · Backs: Activity, LicenceNov 11, 2026
- GitHub API recordgithub.com/chaindead/telegram-mcpNov 10, 2026