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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Telegram MCP Servershow me my unread messages"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
telegram-mcp
Requirements
Python Project Manager, UV
Related MCP server: MCP-Communicator-Telegram
Usage
install dependencies
pip3 install uv
uv venv
source .venv/bin/activate
uv syncedit .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
License
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.