Telegram MCP Server

io.github.tolboy/telegram-mcp-tdlib

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

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "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 TDLIB_API_ID>",
        "TDLIB_API_HASH": "<your TDLIB_API_HASH>",
        "TDLIB_PHONE_NUMBER": "<your TDLIB_PHONE_NUMBER>",
        "TDLIB_AUTH_CODE": "<your TDLIB_AUTH_CODE>",
        "TDLIB_2FA_PASSWORD": "<your TDLIB_2FA_PASSWORD>",
        "MCP_READ_ONLY": "true",
        "MCP_TOOL_PROFILE": "reader"
      }
    }
  }
}
Environment variables
  • TDLIB_API_IDrequiredTelegram API ID from my.telegram.org
  • TDLIB_API_HASHrequiredsecretTelegram API hash from my.telegram.org
  • TDLIB_PHONE_NUMBERsecretTelegram phone number; omit after preparing a persisted session when using QR authentication
  • TDLIB_AUTH_CODEsecretOne-time Telegram login code for a fresh headless container
  • TDLIB_2FA_PASSWORDsecretTelegram 2FA password when the account requires it
  • MCP_READ_ONLYKeep true for safe first use
  • MCP_TOOL_PROFILETool surface: reader, inbox, community-admin, research, or all

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
1.19.1
Registry
active
Published
11/2/2026

More Developer Tools servers

Browse all Developer Tools →

Toleno Network

tolenonetwork

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Developer ToolsAdded 8 months ago

Toleno Network

tolenonetwork

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Developer ToolsAdded 8 months ago

Tolgee

tolgee

Your app's translations in Tolgee: search keys, create translations, trigger machine translation

Developer ToolsAdded 7 months ago

TollWire Evidence

TollWire

Tamper-evident evidence log of agent changes, scans and approvals, mapped to ISO 27001/NIS2.

Developer ToolsAdded 4 days ago

Tendem MCP server

Toloka

Delegate tasks to vetted human experts - research, writing, analysis, and data work.

Developer ToolsAdded 3 months ago

io.github.Tolomere21/latam-mcp

Tolomere21

Peruvian public data — SUNAT RUC, BCRP FX, SEACE tenders. Sourced from official open-data.

Developer ToolsAdded 6 months ago

Add the badge to your site

Show visitors that Telegram MCP Server is listed here — it’s also the link we check for a free listing.

Telegram MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-tolboy-telegram-mcp-tdlib?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Telegram MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Telegram MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-tolboy-telegram-mcp-tdlib?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.