LocalFree

Telegram MCP server

tolboy/telegram-mcp-tdlib

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

12 GitHub stars2 forks

Install Telegram in Claude Code

Claude Code
claude mcp add tolboy-telegram -e TDLIB_API_ID=... -e TDLIB_API_HASH=... -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.18.0-stdio
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "tolboy-telegram": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TDLIB_API_ID",
        "-e",
        "TDLIB_API_HASH",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.18.0-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "...",
        "TDLIB_API_HASH": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Telegram MCP server do?

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

Is the Telegram MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does Telegram run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Telegram to Claude Code?

Run: claude mcp add tolboy-telegram -e TDLIB_API_ID=... -e TDLIB_API_HASH=... -- docker run -i --rm -e TDLIB_API_ID -e TDLIB_API_HASH ghcr.io/tolboy/telegram-mcp-tdlib:1.18.0-stdio

More communication MCP servers

View all