MCP Server

Telegram MCP Server

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.

10

GitHub Stars

3/10/2026

Last Updated

No Configuration

Please check the documentation below.

README Documentation

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

Quick Actions

View on GitHub View All Servers

Key Features

Model Context Protocol

Secure Communication

Real-time Updates

Open Source

Boost your projects with Wisdom Gate LLM API

Supporting GPT-5, Claude-4, DeepSeek v3, Gemini and more.

Enjoy a free trial and save 20%+ compared to official pricing.