Telegram MCP Server
telegrama-mcp
Requisitos
Gerente de proyectos de Python, UV
Related MCP server: io.github.daedalus/mcp-telegram-bot
Uso
instalar dependencias
pip3 install uv
uv venv
source .venv/bin/activate
uv syncedite el archivo .env con su ID de API de Telegram y hash ( Mi Telegram ), no lo comparta con otros.
iniciar el servidor http
uv run http-server/http-server.py
instalar el servidor MCP
uv run mcp install mcp-server/mcp-server.py
Funciones disponibles
El servidor MCP proporciona las siguientes funciones:
get_unread_entities: Obtener entidades que tienen mensajes no leídos en ellasget_unread_messages(id): obtiene todos los mensajes no leídos de una entidad con un ID determinadoget_messages(id, count): Obtener mensajes limitados por un conteo de una entidadget_entities: Obtener todas las entidades en la sesión actualget_entity_by_id(id): obtiene una entidad de la sesión actualsend_message(entity_id, content, reply_to_message_id): envía un mensaje a una entidad con marcado opcional y respuesta
Problemas comunes y cómo solucionarlos
Claude no puede ejecutar el servidor MCP >> Instalar uv con brew:
brew install uvNo puedo crear una nueva aplicación en Telegram >> Desconecte la VPN y vuelva a intentarlo
Licencia
Available Tools
6 toolsget_entitiesB
Get all entities in the current session
Inputs: no named parameters.
get_entity_by_idC
Get an entity from the current session
Inputs: id.
get_messagesC
Get messages limited by a count from an entity
Inputs: id (required), count.
get_unread_entitiesC
get entitites which have unread messages in it
Inputs: no named parameters.
get_unread_messagesC
get all unread messages from a given entity id
Inputs: id.
send_messageC
Send a message to an entity with optional markup and reply
Inputs: entity_id (required), content, reply_to_message_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes, but there is some overlap between get_entities and get_unread_entities, as both retrieve entities, which could cause confusion about which to use. However, the descriptions clarify that one gets all entities and the other gets only those with unread messages, mitigating ambiguity.
All tool names follow a consistent verb_noun pattern with snake_case, such as get_entities, send_message, and get_unread_messages. There are no deviations in naming conventions, making the set predictable and easy to understand.
With 6 tools, this server is well-scoped for managing Telegram sessions, covering key operations like retrieving entities, messages, and sending messages. The count is appropriate, avoiding bloat while providing essential functionality.
The toolset covers core messaging workflows, including reading and sending messages, but lacks operations for updating or deleting messages, which might be expected in a messaging domain. However, the provided tools handle the primary use cases effectively.
Maintenance
Related MCP Connectors
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Unified messaging MCP server: WhatsApp, Instagram, Telegram, SMS, Messenger & email support inbox
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Telegram to send, read, and search messages across chats and dialogs. It supports waiting for incoming messages and retrieving conversation history through natural language commands.31 npm3MIT
- AlicenseAqualityDmaintenanceMCP server that exposes a Telegram bot, enabling sending messages and retrieving updates through natural language.342 PyPI1MIT
- FlicenseAqualityDmaintenanceAn MCP server for interacting with Telegram bots and channels using the Telegraf library. It allows AI agents to send messages, manage channels, forward content, and intelligently respond to Telegram conversations.552 npm8-
- AlicenseNot gradedqualityDmaintenanceAn MCP server for sending and receiving Telegram messages via a bot, enabling AI assistants to interact directly through Telegram by sending messages, reading recent messages, and sending photos.620 npmMIT