mcp-telegram
An early-stage local MCP server that gives Claude Desktop read-only access to your Telegram account through the Telegram API.
What it does
An early-stage local MCP server that gives Claude Desktop read-only access to your Telegram account through the Telegram API. It is installed from the repository with uv, and you sign in once with an API id and hash from my.telegram.org, your phone number, the code Telegram sends and any 2FA password. At present it can list your dialogs (chats, channels and groups) and fetch unread or recent messages in one of them; marking read, contacts, drafts and media downloads are listed as not done yet. The README warns that misusing the Telegram API can get an account suspended.
Capabilities
- List Telegram chats, channels and groups
- Read unread messages in a dialog
About
- Publisher
- sparfenyuk
- Tool
- Telegram
Works with
Install
- Run this to add it to Any client:
uv tool install git+https://github.com/sparfenyuk/mcp-telegram
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Telegram | |
| Publisher | sparfenyuk | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | No | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Mar 14, 2025190 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
Sources
- README (README.md)github.com/sparfenyuk/mcp-telegram · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, PublisherNov 12, 2026
- Licence file (LICENSE)github.com/sparfenyuk/mcp-telegram · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/sparfenyuk/mcp-telegram · Backs: Activity, LicenceNov 11, 2026
- GitHub API recordgithub.com/sparfenyuk/mcp-telegramNov 10, 2026