Skip to content
MCP server

Chatroost — unofficial Telegram MCP server

Unofficial Telegram MCP server that reads, searches and replies as your own account

Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally or Remotely
Version
1.46.0
Listing updated
3 days ago

About Chatroost — unofficial Telegram MCP server

Chatroost — unofficial Telegram MCP server is an open-source MCP server for communication. It can run locally on your machine or as a hosted remote server.

Unlike a bot, this server runs as a userbot over Telegram's MTProto protocol, using the GramJS library, so it acts as your personal account with access to your chats, contacts and message history. That makes it broader than a Bot API integration, and also means you should think carefully about what you let an assistant do.

The README lists a very wide feature set: forum topics, stickers, polls and scheduled messages, chat folders, global search, inline bots and buttons, stories, read receipts, channel statistics, admin controls, Telegram Business settings, and opt-in Star gifts. A shared daemon lets several MCP clients use one Telegram session, and sign-in is by scanning a QR code.

Two routes exist. The npm package runs locally over stdio and needs Node.js 18 or later plus an API ID and hash from my.telegram.org. The hosted Chatroost connector for Claude.ai and ChatGPT skips those keys and links an account by QR code, and supports several accounts at once. It is described as unofficial and open source.

Install

Run in a terminal

claude mcp add --transport http mcp-telegram https://mcp.mcp-telegram.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.mcp-telegram.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-telegram": {
      "type": "http",
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-telegram": {
      "serverUrl": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-telegram": {
      "type": "http",
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

Configuration

  • TELEGRAM_API_IDTelegram API ID from https://my.telegram.org/appsRequired
  • TELEGRAM_API_HASHTelegram API hash from https://my.telegram.org/appsRequired

What it does

Read and search chats
Browse messages with date filters and search across chats, contacts and channels.
Send and react
Reply, send photos, voice notes and documents, add reactions and update drafts.
Multiple accounts
Connect several Telegram accounts and switch between them.
Stories
Read, post, edit and review views of stories.
Forum topics and folders
Work with per-topic messages and manage chat folders.
QR code login
Link an account by scanning a code in Telegram's Devices screen.

Good for

  • Summarize unread messages and flag urgent ones
  • Find messages about a deadline in a work chat
  • List links shared in a channel this week
  • See who is most active in a community group
  • Draft replies to messages in your own account

Pricing

Open source

Open-source package; hosted connector pricing not published

Prices change. Check mcp-telegram.com before you buy.

Chatroost — unofficial Telegram MCP server FAQ

Is it an official Telegram product?

No. It is described as unofficial.

Is it a bot?

No. It runs as a userbot under your personal account over MTProto.

What do I need to run it locally?

Node.js 18 or later and an API ID and hash from my.telegram.org.

Do I need keys for the hosted version?

No. The hosted connector uses a QR code scan instead of API keys.

Is Chatroost — unofficial Telegram MCP server free?

Yes. Chatroost — unofficial Telegram MCP server is open source, so you can use and self-host it for free.

How do I add Chatroost — unofficial Telegram MCP server to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-telegram https://mcp.mcp-telegram.com/mcp

What are the best alternatives to Chatroost — unofficial Telegram MCP server?

The closest alternatives to Chatroost — unofficial Telegram MCP server are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Chatroost — unofficial Telegram MCP server

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity