telegram-mcp
Provides Telegram chat, group management, and message operation capabilities for MCP clients via Telethon.
- Type
- MCP
- Transport
- stdio
- Open source
- Yes
- GitHub Stars
- ★ 1.2k
- Source
- mcp-github
- Repository
- github.com/chigwell/telegram-mcp
Overview
The Telegram MCP server leverages the Telethon library, enabling MCP-compatible clients to read chat history, manage groups and channels, send and edit messages, media, contacts, and settings. This functionality allows AI to access and manipulate Telegram accounts, suitable for scenarios requiring Telegram integration. Integration involves configuring environment variables and running the server. Ideal for developers and users needing automated Telegram operations.
Capabilities
- ▪Read chat history
- ▪Manage groups and channels
- ▪Send and edit messages
- ▪Handle media files
- ▪Manage contacts
- ▪Update profile and privacy settings
Use cases
Setup
1. Clone the repository: `git clone https://github.com/chigwell/telegram-mcp.git`; 2. Install dependencies: `cd telegram-mcp && uv sync`; 3. Generate session string: `uv run session_string_generator.py`; 4. Configure environment variables: `cp .env.example .env` and fill in real values; 5. Run the server: `uv run main.py`.
This information was compiled by AI from public sources and may contain inaccuracies — please refer to the source.
FAQ
How do I get Telegram API credentials?
Visit my.telegram.org/apps to apply for API ID and API Hash.
Which MCP clients are supported?
Supports MCP-compatible clients such as Claude Desktop, Cursor, and others.
Related skills
interview-coach-skill
Tool-readyInterview Coach skill covering the entire job search lifecycle from resume optimization to mock interviews.
skillpack
Package AI capabilities into local agents for use in Slack and Telegram.
harness-anything
AI agent control center supporting automation for WPS/MS Office, Zotero, Photoshop, and other software.
i-have-adhd
Optimize AI output to be more concise and action-oriented, tailored for users with ADHD.
gemini-notebook-mcp-cli
Access Gemini Notebook via command-line interface and MCP server.
whatsapp-mcp
WhatsApp MCP server that allows AI to read and send WhatsApp messages.