MCP Server

Telegram (mcp-telegram) MCP Server

Name: Telegram (mcp-telegram) MCP Server
Author: io.github.mcp-telegram

io.github.mcp-telegram/mcp-telegram

Repository Registry

What is the Telegram (mcp-telegram) MCP server?

MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.

How to install Telegram (mcp-telegram)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

TELEGRAM_API_ID
required
secret
Telegram API ID from https://my.telegram.org/apps
TELEGRAM_API_HASH
required
secret
Telegram API hash from https://my.telegram.org/apps

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-telegram --env TELEGRAM_API_ID=<YOUR_TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<YOUR_TELEGRAM_API_HASH> -- npx -y @overpod/mcp-telegram