# Chatroost — unofficial Telegram MCP server

> Chatroost — unofficial Telegram MCP server is an open-source MCP server for communication. Unofficial Telegram MCP server that reads, searches and replies as your own account. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://mcp-telegram.com
- **Repository:** https://github.com/mcp-telegram/mcp-telegram
- **MCP Registry name:** io.github.mcp-telegram/mcp-telegram
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.mcp-telegram.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/chatroost-unofficial-telegram-mcp-server
