Telegram MCP Server (chigwell)

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "telegram-mcp-server-chigwell": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "<your-telegram-api-id>",
        "TELEGRAM_API_HASH": "<your-telegram-api-hash>",
        "TELEGRAM_SESSION_STRING": "<your-generated-session-string>"
      }
    }
  }
}

Before you start

• Python 3.10+ (uv recommended for dependency management)
• A Telegram account (this controls a real user account, not a bot)
• TELEGRAM_API_ID and TELEGRAM_API_HASH obtained from https://my.telegram.org/apps
• A Telegram session string generated with the bundled session_string_generator.py (QR or phone login)
• An MCP client such as Claude Desktop or Cursor

About Telegram MCP Server (chigwell)

Tools & capabilities (11)

When to use it

• Use it when you want an assistant to read and summarize your Telegram chats and channels
• Use it to send, schedule, or forward messages and media from your own account
• Use it to administer groups/channels — invites, admins, bans, permissions, topics
• Use it to manage contacts in bulk (add, block, import/export)
• Use it across multiple Telegram accounts routed by label from one MCP server
• Use it when bot-API limitations block you and you need full user-account (MTProto) access

Quick setup

1. 1Register an app at my.telegram.org/apps to get TELEGRAM_API_ID and TELEGRAM_API_HASH
2. 2Clone the repo and install dependencies with uv
3. 3Run session_string_generator.py and sign in (QR or phone) to produce a session string
4. 4Put the API credentials and session string in a .env file
5. 5Add the server to your MCP client config (run main.py) and restart the client
6. 6Verify by calling get_chats or list_chats

Telegram MCP Server (chigwell) FAQ