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

Usage

  1. install dependencies
pip3 install uv uv venv source .venv/bin/activate uv sync
  1. edit .env file with your telegram api id and hash (My Telegram), don't share with others.
  2. start the http-server

uv run http-server/http-server.py

  1. 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.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

  1. Requirements
    1. Usage
      1. Available Functions
        1. Common Issues & How to Fix
          1. License

            Related MCP Servers

            • -
              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
            • 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
            • -
              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 -
              85
              Python
              Apache 2.0
              • Apple
              • Linux
            • -
              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

            ID: 9oat3exviw