telegram-mcp

Level ALocal

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

Overview

A Telegram MCP server built on Telethon that connects Claude, Cursor, and other MCP clients to Telegram accounts. It offers 80+ tools for reading chats, managing groups and channels, sending and editing messages, handling media, contacts, and folders, with multi-account routing, chat allowlists, and contact aliases.

⭐ 2.1kSearch & InfoPythonRepo ↗Updated 2026-11-17

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "chigwell-telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/chigwell/telegram-mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "chigwell-telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers