Telegram MCP Server

Integrations

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
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 them
get_unread_messages(id): Get all unread messages from a given entity id
get_messages(id, count): Get messages limited by a count from an entity
get_entities: Get all entities in the current session
get_entity_by_id(id): Get an entity from the current session
send_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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

An MCP server that enables interaction with Telegram messaging platform, allowing users to retrieve unread messages, fetch entity information, and send messages through natural language interfaces.

Related MCP Servers

MCP-Communicator-Telegram
qpd-v
-
security
F
license
-
quality
An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.
Last updated -
1
16
JavaScript
MCP Server Discord Webhook
genm
A
security
A
license
A
quality
An MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.
Last updated -
1
0
JavaScript
MIT License
Telegram MCP Server
chigwell
-
security
A
license
-
quality
A server that enables interaction with Telegram chats directly through MCP-compatible hosts like Claude for Desktop, providing tools to retrieve chats, get messages, and send messages.
Last updated -
134
Python
Apache 2.0
YaVendió Toolsofficial
YaVendio
-
security
-
license
-
quality
An MCP-based messaging system that allows AI systems to interact with various messaging platforms through standardized tools for sending text, images, documents, buttons, and alerts.
Last updated -
Python

View all related MCP servers