mcp-registry/telegram-mcp


    ==================
      
       /// MCP ///
      /// TEL ///
        
    ==================
        
    [server:online]
    [protocol:ready]

telegram-mcp

by chigwell

Full-featured Telegram MCP server that exposes nearly the entire Telegram/Telethon API as MCP tools for Claude, Cursor or any MCP-compatible client.

256

Open Source

Installation

1. Clone the repository

   git clone https://github.com/chigwell/telegram-mcp.git
   cd telegram-mcp

2. Create and activate a virtual environment (recommended)

   python -m venv .venv
   source .venv/bin/activate   # Windows: .venv\Scripts\activate

3. Install Python dependencies

pip install -r requirements.txt

4. Create an environment file called `.env` (or export variables directly) with at least:

   TELEGRAM_BOT_TOKEN=<your-telegram-bot-token>
   MCP_API_KEY=<optional-key-if-your-models-need-auth>

5. Launch the MCP server / bot gateway

python main.py # or the entry-point script defined in the repo

6. (Optional) Run tests

pytest

License: Apache License 2.0

Updated 7/30/2025