Creativity · MCP — server

MCP Telegram Server

The MCP Telegram Server is a community-maintained Model Context Protocol server wrapping the Telegram Bot API. It lets an MCP client send and read messages, manage chat membership, and broadcast notifications from Claude Desktop or Cursor using a standard Telegram bot token.

MCP facts

Kind
server
Ecosystem
anthropic-mcp
Language
Python
Transports
stdio

Capabilities

  • Tools: send_message, get_chat, get_updates, forward_message, answer_callback_query
  • Resources: telegram://chat/{chat_id} URIs for pinned chats
  • Auth: bot token obtained from @BotFather

Install

pip install mcp-server-telegram && python -m mcp_server_telegram

Configuration

{
  "mcpServers": {
    "telegram": {
      "command": "python",
      "args": ["-m", "mcp_server_telegram"],
      "env": { "TELEGRAM_BOT_TOKEN": "123456:ABC-..." }
    }
  }
}

Frequently asked questions

Is this server official?

No — it is community-maintained. Telegram has no first-party MCP implementation; pick a repo with active maintainers and review the code before running.

How do I get a Telegram bot token?

Message @BotFather inside Telegram, run /newbot, and save the token it returns. Add it to the MCP server's env block.

Can this server read messages from private user chats?

Only if users have explicitly started the bot. Bots cannot read arbitrary user DMs — Telegram's API enforces this.

Sources

  1. Telegram Bot API — accessed 2026-04-20
  2. MCP community servers — accessed 2026-04-20