Telegram MCP Server

A Telegram MCP (Model Context Protocol) server built using Python, Telethon, and MCP Python SDK. This server facilitates interaction with Telegram chats through MCP-compatible hosts like Claude for Desktop.

Tools Provided

• get_chats: Retrieves a paginated list of Telegram chats.
• get_messages: Retrieves paginated messages from a specified chat.
• send_message: Sends a message to a specified chat.

Requirements

• Python 3.10+
• Telethon
• MCP Python SDK
• UV (optional)

Installation and Setup

1. Clone the repository and navigate into it.
2. Create a .env file with Telegram API credentials from https://my.telegram.org/apps.
3. Set up a Python environment using uv, activate it, and install dependencies: mcp[cli], telethon, python-dotenv, and nest_asyncio.
4. Run main.py to authenticate with Telegram.

Integrating with Claude for Desktop

Configure Claude Desktop by editing claude_desktop_config.json and adding the MCP server configuration, ensuring the correct absolute path to the project directory is specified.

Usage

The Telegram tools will be accessible within Claude for Desktop or any MCP-compatible client.

License

Licensed under the Apache 2.0 License.