Chatroost — unofficial Telegram MCP server
Unofficial Telegram MCP server that reads, searches and replies as your own account
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.mcp-telegram.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-telegram": {
"url": "https://mcp.mcp-telegram.com/mcp"
}
}
}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/appsRequiredTELEGRAM_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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity