mcp-telegram

Level CLocal

Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate channels, manage stories/contacts/folders, transcribe voice, and call any raw MTProto method. Browser-based sign-in. 100+ tools.

⭐ 34Browser AutomationTypeScriptRepo ↗Updated 2026-05-18

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "beautyfree-mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/beautyfree/mcp-telegram

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "beautyfree-mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers