tolboy/telegram-mcp-tdlib

Package (oci)

docker run -i --rm ghcr.io/tolboy/telegram-mcp-tdlib:1.19.1-stdio

Or add to your MCP client config:

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

• TDLIB_API_ID required — Telegram API ID from my.telegram.org
• TDLIB_API_HASH required secret — Telegram API hash from my.telegram.org
• TDLIB_PHONE_NUMBER secret — Telegram phone number; omit after preparing a persisted session when using QR authentication
• TDLIB_AUTH_CODE secret — One-time Telegram login code for a fresh headless container
• TDLIB_2FA_PASSWORD secret — Telegram 2FA password when the account requires it
• MCP_READ_ONLY — Keep true for safe first use
• MCP_TOOL_PROFILE — Tool surface: reader, inbox, community-admin, research, or all