Telegram MCP Server

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

What does this entry provide?

Telegram MCP Server is an MCP server entry in ChatHome Skills, sourced from Official MCP Registry and scored 78/100. As a Model Context Protocol server, it exposes tools that MCP-compatible LLM clients such as Claude, Cursor, and Copilot can call directly, extending an agent's reach beyond its built-in capabilities. ChatHome Skills discovered this entry through its daily ingest of official registries and GitHub discovery queries, and re-verifies repository facts, freshness signals, and install metadata on every run. The quality score weighs official-registry presence, a working install command, license clarity, GitHub star trajectory, and repository freshness — the full formula is on the Sources page. The install command above is ready to copy. Review the last-pushed date and repository status before adding Telegram MCP Server to a production agent workflow; the snapshot facts below are point-in-time values from the most recent ingest.

Snapshot facts

Source: Official MCP Registry
Quality: 78/100
Install method: oci
Repo: tolboy/telegram-mcp-tdlib
Repo updated: Oct 17, 2026

Install command

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

Install method: oci

Review the upstream source before running this command.

GitHub project

Quality

Repo stars

Repo updated

Oct 17, 2026

How is this score calculated?

Weighted across six dimensions, scored 0-100.
Provenance (25): listed in an official or curated registry.
Installability (25): a runnable install command beats a declared transport, which beats a source checkout.
Maintenance (20): recency of the last push; archived entries score zero here.
Adoption (20): repository stars on a log curve.

MCP manifest

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-17T14:01:48.912157Z",
      "publishedAt": "2026-10-17T14:01:48.912157Z",
      "statusChangedAt": "2026-10-17T14:01:48.912157Z"
    }
  },
  "server": {
    "name": "io.github.tolboy/telegram-mcp-tdlib",
    "title": "Telegram MCP Server",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "1.17.3",
    "packages": [
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio",
        "registryType": "oci",
        "environmentVariables": [
          {
            "name": "TDLIB_API_ID",
            "format": "string",
            "isRequired": true,
            "description": "Telegram API ID from my.telegram.org"
          },
          {
            "name": "TDLIB_API_HASH",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Telegram API hash from my.telegram.org"
          },
          {
            "name": "TDLIB_PHONE_NUMBER",
            "format": "string",
            "isSecret": true,
            "description": "Telegram phone number; omit after preparing a persisted session when using QR authentication"
          },
          {
            "name": "TDLIB_AUTH_CODE",
            "format": "string",
            "isSecret": true,
            "description": "One-time Telegram login code for a fresh headless container"
          },
          {
            "name": "TDLIB_2FA_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "Telegram 2FA password when the account requires it"
          },
          {
            "name": "MCP_READ_ONLY",
            "format": "string",
            "default": "true",
            "description": "Keep true for safe first use"
          },
          {
            "name": "MCP_TOOL_PROFILE",
            "format": "string",
            "default": "reader",
            "description": "Tool surface: reader, inbox, community-admin, research, or all"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/tolboy/telegram-mcp-tdlib",
      "source": "github"
    },
    "description": "Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails."
  }
}

Report an issue with this listing