Telegram MCP Server

Indexed by io.github.tolboy

About

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

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)

Env varsTDLIB_API_ID TDLIB_API_HASH TDLIB_PHONE_NUMBER TDLIB_AUTH_CODE TDLIB_2FA_PASSWORD MCP_READ_ONLY MCP_TOOL_PROFILE

Claude Code

claude mcp add --env TDLIB_API_ID= --env TDLIB_API_HASH= --env TDLIB_PHONE_NUMBER= --env TDLIB_AUTH_CODE= --env TDLIB_2FA_PASSWORD= --env MCP_READ_ONLY= --env MCP_TOOL_PROFILE= telegram-mcp-tdlib -- docker ghcr.io/tolboy/telegram-mcp-tdlib:1.11.1-stdio

Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code

code --add-mcp '{"name":"telegram-mcp-tdlib","command":"docker","args":["ghcr.io/tolboy/telegram-mcp-tdlib:1.11.1-stdio"],"env":{"TDLIB_API_ID":"","TDLIB_API_HASH":"","TDLIB_PHONE_NUMBER":"","TDLIB_AUTH_CODE":"","TDLIB_2FA_PASSWORD":"","MCP_READ_ONLY":"","MCP_TOOL_PROFILE":""}}'

JSON

{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.11.1-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "",
        "TDLIB_API_HASH": "",
        "TDLIB_PHONE_NUMBER": "",
        "TDLIB_AUTH_CODE": "",
        "TDLIB_2FA_PASSWORD": "",
        "MCP_READ_ONLY": "",
        "MCP_TOOL_PROFILE": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.