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.
cli
Google Workspace CLI provides a unified command-line tool for both humans and AI agents.
pm-claude-skills
Tool-ready207 professional AI skills across 21 career fields.
dashiAI-ppt-skill
AI-generated editable PPTs with support for multiple visual themes and export formats.
mcp-atlassian
MCP server for Atlassian tools (Confluence, Jira).
whatsapp-mcp
WhatsApp MCP server that allows AI to read and send WhatsApp messages.