Chatroost — unofficial Telegram MCP server

📖 Documentation · ☁️ Cloud version — connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code, no API keys needed.

Local + remotestreamable-httpstdioMIT

What is the Chatroost — unofficial Telegram MCP server?

mcp-telegram is an MCP project maintained in the overpod/mcp-telegram repository. The maintainer describes its purpose as “📖 Documentation · ☁️ Cloud version — connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code, no API keys needed”. Read the project documentation for the complete scope.

Installation

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

Configuration values

The example declares TELEGRAM_API_ID, TELEGRAM_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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
CategoryTools
Authtelegram-status, telegram-login, telegram-logout
Messagingtelegram-send-message (incl. quoteText for verbatim reply quotes and Premium message effect), telegram-edit-message, telegram-delete-message…
Scheduledtelegram-get-scheduled, telegram-delete-scheduled
Readingtelegram-list-chats, telegram-read-messages, telegram-search-messages, telegram-search-global, telegram-search-chats, telegram-get-unread…
Draftstelegram-save-draft, telegram-get-drafts, telegram-clear-drafts
Pollstelegram-create-poll
Reactionstelegram-send-reaction, telegram-get-reactions, telegram-set-default-reaction, telegram-get-top-reactions, telegram-get-recent-reactions
Stickerstelegram-send-sticker, telegram-get-installed-stickers, telegram-get-recent-stickers, telegram-get-sticker-set, telegram-search-sticker-sets
Mediatelegram-send-file, telegram-download-media, telegram-get-profile-photo, telegram-get-web-preview
Groupstelegram-create-group, telegram-edit-group, telegram-invite-to-group, telegram-join-chat, telegram-leave-group, telegram-kick-user, telegram-ban-user…
Contactstelegram-get-contacts, telegram-add-contact, telegram-get-contact-requests
Moderationtelegram-block-user, telegram-unblock-user, telegram-report-spam
Accounttelegram-get-sessions, telegram-terminate-session, telegram-set-privacy, telegram-set-auto-delete
Pinningtelegram-pin-message, telegram-unpin-message
Statstelegram-get-broadcast-stats, telegram-get-megagroup-stats
Booststelegram-get-my-boosts, telegram-get-boosts-status, telegram-get-boosts-list

How to install the Chatroost — unofficial Telegram MCP server

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "YOUR_ID",
        "TELEGRAM_API_HASH": "YOUR_HASH"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
TELEGRAM_API_IDDeclared in the maintainer’s client configuration.Check documentation
TELEGRAM_API_HASHDeclared in the maintainer’s client configuration.Check documentation