Community

Telegram MCP Server

io.github.tolboy/telegram-mcp-tdlib

Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails.

Install

Add the config to your client settings. Replace values in <angle brackets> with your own.

claude_desktop_config.json

{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "-e",
        "TDLIB_PHONE_NUMBER",
        "-e",
        "TDLIB_AUTH_CODE",
        "-e",
        "TDLIB_2FA_PASSWORD",
        "-e",
        "MCP_READ_ONLY",
        "-e",
        "MCP_TOOL_PROFILE",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.2-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "<TDLIB_API_ID>",
        "TDLIB_API_HASH": "<TDLIB_API_HASH>",
        "TDLIB_PHONE_NUMBER": "<TDLIB_PHONE_NUMBER>",
        "TDLIB_AUTH_CODE": "<TDLIB_AUTH_CODE>",
        "TDLIB_2FA_PASSWORD": "<TDLIB_2FA_PASSWORD>",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}

Details

Name: io.github.tolboy/telegram-mcp-tdlib
Version: 1.17.2
Updated: Oct 15, 2026
Source: Official MCP Registry
Repository: https://github.com/tolboy/telegram-mcp-tdlib