Telegram MCP Server

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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

imessage-query-fastmcp-mcp-server
hannesrudolph
-
security
F
license
-
quality
An MCP server that provides safe access to your iMessage database through MCP, enabling LLMs to query and analyze iMessage conversations with proper phone number validation and attachment handling
Last updated -
61
Python
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 -
12
36
JavaScript
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 -
244
Python
Apache 2.0
Telegram MCP Server
alexandertsai
-
security
A
license
-
quality
A simple MCP server that allows Claude to access your Telegram account to read and send messages on your behalf.
Last updated -
6
Python
Apache 2.0

View all related MCP servers