mcp-telegram MCP Server

An MCP server that connects AI assistants like Claude to your real Telegram account via the User API (MTProto). Not a bot — Claude reads and sends messages as you.

Local serverstdio

What is the mcp-telegram MCP Server?

mcp-telegram is an MCP project maintained in the prgebish/mcp-telegram repository. The maintainer describes its purpose as “An MCP server that connects AI assistants like Claude to your real Telegram account via the User API (MTProto). Not a bot — Claude reads…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /path/to/mcp-telegram. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

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 mcp-telegram MCP Server

{
  "mcpServers": {
    "telegram": {
      "command": "/path/to/mcp-telegram",
      "args": [
        "serve",
        "--config",
        "/path/to/config.yaml"
      ],
      "env": {
        "TG_APP_ID": "12345",
        "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