telegram-mcp MCP Server

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

Local serverstdio

What is the telegram-mcp Server?

telegram-mcp is an MCP project maintained in the chaindead/telegram-mcp repository. The maintainer describes its purpose as “The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol”. Read the project documentation for the complete scope.

Installation

The documented npm package is @chaindead/telegram-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TG_APP_ID, TG_API_HASH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the telegram-mcp Server

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TG_APP_IDDeclared in the maintainer’s client configuration.Check documentation
TG_API_HASHDeclared in the maintainer’s client configuration.Check documentation