Chatroost — unofficial Telegram MCP Server
by mcp-telegramio.github.mcp-telegram/mcp-telegramv1.43.4
MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Chatroost — unofficial Telegram MCP server
Install in Claude Code
claude mcp add telegram -e TELEGRAM_API_ID='<telegram-api-id>' -e TELEGRAM_API_HASH='<telegram-api-hash>' -- npx -y @overpod/mcp-telegramInstall in Cursor
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<telegram-api-id>",
"TELEGRAM_API_HASH": "<telegram-api-hash>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<telegram-api-id>",
"TELEGRAM_API_HASH": "<telegram-api-hash>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"telegram": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<telegram-api-id>",
"TELEGRAM_API_HASH": "<telegram-api-hash>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"-y",
"@overpod/mcp-telegram"
],
"env": {
"TELEGRAM_API_ID": "<telegram-api-id>",
"TELEGRAM_API_HASH": "<telegram-api-hash>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| TELEGRAM_API_ID | yes | yes | Telegram API ID from https://my.telegram.org/apps |
| TELEGRAM_API_HASH | yes | yes | Telegram API hash from https://my.telegram.org/apps |
Remote endpoints
- streamable-http
https://mcp.mcp-telegram.com/mcp
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-10-05 · 4d ago · GitHub · v1.43.4
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v1.43.4
FAQ
›How do I install the Chatroost — unofficial Telegram MCP server in Claude Code?
Run: claude mcp add telegram -e TELEGRAM_API_ID='<telegram-api-id>' -e TELEGRAM_API_HASH='<telegram-api-hash>' -- npx -y @overpod/mcp-telegram. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Chatroost — unofficial Telegram require an API key?
Yes. It expects TELEGRAM_API_ID, TELEGRAM_API_HASH, of which 2 are secrets.
›Can I use Chatroost — unofficial Telegram as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Chatroost — unofficial Telegram in the official MCP registry?
Yes, as io.github.mcp-telegram/mcp-telegram.
Alternatives to Chatroost — unofficial Telegram
Other communication MCP servers.