telegram-mcp

telegram-mcp

Provides Telegram chat, group management, and message operation capabilities for MCP clients via Telethon.

MCPOfficeOpen source
Type
MCP
Transport
stdio
Open source
Yes
GitHub Stars
★ 1.2k
Source
mcp-github

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

Automatically reply to customer messagesBatch manage group membersSchedule notification broadcastsAnalyze chat data

Setup

Requires: API KeyNode 环境
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