Chatroost — Telegram MCP server for Claude Code
Connect an AI assistant to Telegram to search chats, read messages, reply, and react. It works through your personal account rather than a bot account.
claude mcp add --transport http mcp-telegram https://mcp.mcp-telegram.com/mcpWhat Chatroost — unofficial Telegram MCP server does
Chatroost connects an assistant to Telegram over MTProto. It can search across chats, read conversations, send replies, and add reactions; tools for forum topics and contacts are included too. The server acts as a userbot, so actions use your own Telegram account.
A local setup needs Node.js 18 or later, plus TELEGRAM_API_ID and TELEGRAM_API_HASH from my.telegram.org. Sign in by scanning a QR code in Telegram, then the session is saved for later runs. Accounts with two-step verification also need the Telegram password during login.
In Claude Code, you can add the hosted HTTP server with the command below. A local connection gives the assistant access to chats under your personal account, so consider that before connecting it.
What it helps with
- search messages across Telegram chats
- read a conversation and draft a reply
- send a message from your personal account
- react to a Telegram message
- read messages in a forum topic
Example prompts for the agent
- Find Telegram messages about the release and summarize them.
- Read the latest message in the team chat and draft a reply.
- React to the newest message in this conversation.
How to install Chatroost — unofficial Telegram MCP server
1Platform CLI: remote server
claude mcp add --transport http mcp-telegram https://mcp.mcp-telegram.com/mcp2Platform CLI
claude mcp add --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> --transport stdio chatroost-unofficial-telegram-mcp-server -- npx -y @overpod/mcp-telegramReplace <…> with your own values
1Platform CLI: remote server
codex mcp add chatroost-unofficial-telegram-mcp-server --url https://mcp.mcp-telegram.com/mcp2Platform CLI
codex mcp add chatroost-unofficial-telegram-mcp-server --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -- npx -y @overpod/mcp-telegramReplace <…> with your own values
Config file
{
"mcpServers": {
"chatroost-unofficial-telegram-mcp-server": {
"url": "https://mcp.mcp-telegram.com/mcp"
}
}
}{
"mcpServers": {
"chatroost-unofficial-telegram-mcp-server": {
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"chatroost-unofficial-telegram-mcp-server": {
"type": "http",
"url": "https://mcp.mcp-telegram.com/mcp"
}
}
}{
"servers": {
"chatroost-unofficial-telegram-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http chatroost-unofficial-telegram-mcp-server https://mcp.mcp-telegram.com/mcp2Platform CLI
gemini mcp add -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> chatroost-unofficial-telegram-mcp-server npx -y @overpod/mcp-telegramReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Chatroost — unofficial Telegram MCP server
How do I install Chatroost in Claude Code?
Add the HTTP server with claude mcp add --transport http chatroost-unofficial-telegram-mcp-server https://mcp.mcp-telegram.com/mcp.
What does Chatroost do?
It connects an AI assistant to Telegram for reading and searching chats, sending replies, and adding reactions. It operates through your personal account, not a separate bot account.
What is needed to run Chatroost locally?
You need Node.js 18 or later and the TELEGRAM_API_ID and TELEGRAM_API_HASH values. Telegram login uses a QR code and saves the session for later use.
