Telegram MCP Server
A Python MCP server built on Telethon that signs in to Telegram as your own user account over MTProto, using an API id and hash from my.telegram.org and a session string you generate first.
What it does
A Python MCP server built on Telethon that signs in to Telegram as your own user account over MTProto, using an API id and hash from my.telegram.org and a session string you generate first. It has over 80 tools for chats, groups, channels, messages, contacts, media, folders and admin rights, including sending, scheduling, editing, deleting and forwarding messages, polls and reactions, inline buttons, voice transcription and exporting chat history to JSON. It runs locally over stdio or as a shared HTTP server, supports several accounts, and can restrict access to a list of allowed chats. Docker images and a Claude Desktop extension are offered.
Capabilities
- Send, edit, schedule and delete Telegram messages
- Manage groups, channels, admins and invite links
- Search messages and export chat history to JSON
- Manage contacts and folders
- Transcribe voice messages
About
- Publisher
- chigwell
- Tool
- Telegram
Works with
Install
- Run this to add it to Claude Code:
claude mcp add --transport http telegram http://127.0.0.1:8765/mcp
From the project's documentation · Add to a config file with the config builder
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 | chigwell | 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 | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop, Cursor, Codex | source |
| Licence | Apache-2.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 17, 2026Version 2.0.12,059 GitHub starsDownload counts not collected | source |
| Links | Repository pypi: iflow-mcp_arlanrakh-talk-to-girlfriend-ai |
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/servers/chigwell-iflow-mcp-arlanrakh-talk-to-girlfriend-ai/)
Sources
- README (README.md)github.com/chigwell/telegram-mcp · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, PublisherNov 12, 2026
- Licence file (LICENSE)github.com/chigwell/telegram-mcp · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/chigwell/telegram-mcp · Backs: Activity, LicenceNov 19, 2026
- PyPI package recordpypi.org/project/iflow-mcp_arlanrakh-talk-to-girlfriend-aiNov 19, 2026