Other · Local MCP server

Telegram MCP Server

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

What the MCP Registry states

The entry as published to the official MCP Registry (read 2026-10-04), latest version.

Registry name
io.github.tolboy/telegram-mcp-tdlib
Version
1.17.0
Status
Active
Category
other
Transport
stdio (local process)
Package
OCI image (Docker)
Published
2026-09-29
Updated
2026-09-29
Publisher
tolboy (GitHub)
Namespace
Namespace verified by the MCP Registry via GitHub (github.com/tolboy) · how
Listed under
Telegram MCP servers
Repository
github.com/tolboy/telegram-mcp-tdlib
Source
Registry API entry

Packages

RegistryPackageVersionTransportEnvironment variables
OCI image (Docker)ghcr.io/tolboy/telegram-mcp-tdlib:1.17.0-stdio-stdioTDLIB_API_ID (required), TDLIB_API_HASH (required, secret), TDLIB_PHONE_NUMBER (secret), TDLIB_AUTH_CODE (secret), TDLIB_2FA_PASSWORD (secret), MCP_READ_ONLY, MCP_TOOL_PROFILE

How to connect Telegram MCP Server

Telegram MCP Server runs locally from a container image in an OCI registry such as Docker Hub or GitHub Container Registry: ghcr.io/tolboy/telegram-mcp-tdlib:1.17.0-stdio. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Docker or another OCI container runtime; started with docker run - the usual command is docker 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.0-stdio. It reads these environment variables: TDLIB_API_ID (required), TDLIB_API_HASH (required, secret), TDLIB_PHONE_NUMBER (secret), TDLIB_AUTH_CODE (secret), TDLIB_2FA_PASSWORD (secret), MCP_READ_ONLY and MCP_TOOL_PROFILE; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "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.0-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "<value>",
        "TDLIB_API_HASH": "<secret>",
        "TDLIB_PHONE_NUMBER": "<secret>",
        "TDLIB_AUTH_CODE": "<secret>",
        "TDLIB_2FA_PASSWORD": "<secret>",
        "MCP_READ_ONLY": "<value>",
        "MCP_TOOL_PROFILE": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect

More other servers

All 8,395 →
ServerRunsEndpoint or package
TelegramTelegram: FASTEST real time Telegram API. Retrieve channel's info and messages in milliseconds..Remote · HTTPLive check: ✓ handshakemcp.jojapi.com
Telegram Agent by Nova (CIVAI)I use your linked Telegram MTProto session (Integrations → Telegram) to list groups, members, and s…Remote · HTTPLive check: ✓ handshakenova.civai.co
Telegram BridgeStdio MCP bridge to Telegram Bot API with scrubbing and chat allowlist.Local · stdioPyPI: mcp-telegram-bridge
Telegram Managed Bot FactoryProvision owner-confirmed isolated Telegram Managed Bot instances.Local · stdioPyPI: telegram-managed-bot-factory
TeleKashOracle MCP-SERVERPrediction market probability oracle. 500+ markets from Kalshi, Polymarket & Metaculus.Local · stdionpm: telekash-mcp-server
TelememLong-term and multimodal memory for AI agents - character-aware, mem0-compatible, fully-local option.Local · stdioPyPI: telemem
TeleprompterRead and write your Teleprompter.com scripts and folders: list, create, update, and organize.Remote · HTTPLive check: sign-in requiredapp.teleprompter.com
TeleQuick PlatformTenant-scoped control plane over the TeleQuick platform's full API surface.Remote · HTTPLive check: sign-in requiredportal.telequick.dev