The Telegram MCP Server enables programmatic interaction with Telegram, offering the following capabilities:
Retrieve Unread Entities: Access chats or channels with unread messages
Fetch Unread Messages: Get all unread messages from a specific entity
Get Messages: Retrieve a limited number of recent messages from an entity
List All Entities: View all users, groups, or channels in the current session
Find Entity by ID: Get details for a specific entity
Send Messages: Communicate with entities, including options for markup and message replies
Provides access to Telegram messaging platform, enabling reading unread messages, retrieving conversation history, sending messages, and managing communication entities within a Telegram account.
telegram-mcp
Requirements
Python Project Manager, UV
Related MCP server: MCP-Communicator-Telegram
Usage
install dependencies
edit .env file with your telegram api id and hash (My Telegram), don't share with others.
start the http-server
uv run http-server/http-server.py
install the MCP Server
uv run mcp install mcp-server/mcp-server.py
Available Functions
The MCP Server provides the following functions:
get_unread_entities: Get entities which have unread messages in themget_unread_messages(id): Get all unread messages from a given entity idget_messages(id, count): Get messages limited by a count from an entityget_entities: Get all entities in the current sessionget_entity_by_id(id): Get an entity from the current sessionsend_message(entity_id, content, reply_to_message_id): Send a message to an entity with optional markup and reply
Common Issues & How to Fix
Claude can't run MCP server >> Install uv with brew :
brew install uvCan't create new app in Telegram >> Disconnect VPN and retry