telegram-mcp
Requirements
- Python Project Manager, UV
- MCP Client
Usage
- install dependencies
pip3 install uv
uv venv
source .venv/bin/activate
uv sync
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 uv - Can’t create new app in Telegram >> Disconnect VPN and retry
License
MIT
Telegram MCP Server
Project Details
- prem-research/telegram-mcp
- Last Updated: 4/26/2025
Recomended MCP Servers
A mockup full stack app built with React, FastAPI, MongoDB, and Docker, powered by CLIP for multi-tagging and...
A MCP server for automated website deployment to 1Panel (Experimental)
MCP server to connect to the Teamwork API
Un serveur MCP pour gérer les interactions avec l'API GitHub
MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.
MCP Server for Zerocracy: add it to Claude Desktop and enjoy vibe-management
MCP server for retrieval augmented thinking and problem solving





