Skip to main content
Glama

Telegram MCP Server

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

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

local-only server

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

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 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
              • Apple
            • -
              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
            • -
              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
              • Apple
              • Linux
            • -
              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
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/prem-research/telegram-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server