Chatroost — unofficial Telegram MCP server

Name: Chatroost — unofficial Telegram MCP server
Author: mcp-telegram

von mcp-telegramVersion 1.45.1i★ 65iComputer oder Cloud

Name in der Registryio.github.mcp-telegram/mcp-telegram

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi5 von 5 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu★ 65

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Computer oder Cloud
Transport: stdio, Streamable HTTP
Kategorie: Chat & E-Mail
Das musst du eintragen: TELEGRAM_API_ID, TELEGRAM_API_HASH

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 5 von 5 bestanden
Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
Das trägst du selbst ein: TELEGRAM_API_ID, TELEGRAM_API_HASH

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet
npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:

Öffne Settings → Connectors
Tippe auf Add custom connector
Füge die Adresse unten ein und tippe auf Add
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

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

Oder führ ihn auf deinem Computer aus

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

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

Oder führ ihn auf deinem Computer aus

claude mcp add telegram --env TELEGRAM_API_ID=your-value --env TELEGRAM_API_HASH=your-value -- npx -y @overpod/mcp-telegram

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Oder führ ihn auf deinem Computer aus

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Oder führ ihn auf deinem Computer aus

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

ChatGPT verbindet sich nur mit Servern im Internet:

Öffne ChatGPT im Web → Settings → Connectors (Apps)
Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
Füge die Adresse unten ein, gib ihr einen Namen und speichere
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

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

Menünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

TELEGRAM_API_ID geheim erforderlich env
Telegram API ID from https://my.telegram.org/apps
TELEGRAM_API_HASH geheim erforderlich env
Telegram API hash from https://my.telegram.org/apps

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Die Tool-Liste dieses Servers haben wir noch nicht gelesen; wir prüfen die Endpunkte reihum.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto mcp-telegram bestätigt, dem das Repo gehört
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 4 Tagen
✓ Bestanden
Hat eine Lizenz
Nutzt MIT
✓ Bestanden
Endpunkt antwortet
Antwort in 745 ms (HTTP 401)
✓ Bestanden
Anmeldung mit OAuth
Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Im Vergleich mit anderen in Chat & E-Maili

Mehr Sterne als 100 % der anderen 1762 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 84 % der anderen 1762 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1762 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Chatroost — unofficial Telegram MCP server sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: TELEGRAM_API_ID, TELEGRAM_API_HASH

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 4 Tagen geändert, und die neueste Version (1.45.1) kam vor 4 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Vexa, emailmd, MCP WhatsApp Cloud

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Vexa

von Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Läuft in der Cloud★ 2.949Apache-2.0Aktualisiert vor 2 Monaten

Installieren

emailmd

von anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer oder Cloud★ 1.385MITAktualisiert vor 30 Tagen

Installieren

MCP WhatsApp Cloud

von codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Läuft auf deinem Computer★ 277MITAktualisiert vor 5 Monaten

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Telegram MCP Server

[📖 Documentation](https://mcp-telegram.github.io/mcp-telegram/) · [☁️ Cloud version](https://mcp-telegram.com) — connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code, no API keys needed.

Telegram MCP Server — a Model Context Protocol server that connects AI assistants like Claude and ChatGPT to Telegram via the MTProto protocol. Unlike bots, this runs as a userbot -- it operates under your personal Telegram account using GramJS, giving full access to your chats, contacts, and message history.

Features

Comprehensive tool coverage -- the most full-featured Telegram MCP server available
MTProto protocol -- direct Telegram API access, not the limited Bot API
Userbot -- operates as your personal account, not a bot
Full-featured -- messaging, reactions, polls, scheduled messages, stickers, media, contacts, and more
Forum Topics -- list topics, read per-topic messages, send to specific topics, per-topic unread counts
Stickers -- search sticker sets, browse installed/recent stickers, send stickers to any chat
Account & profile management -- update profile, set emoji status, birthday, personal channel, profile photo, manage privacy settings, sessions, auto-delete timers
Chat folders -- create, edit, delete and reorder folders, toggle folder tags, read suggested folders (v1.33.0)
Global privacy -- read and set account-wide privacy settings (v1.33.0)
Global search -- search messages across all chats at once
Real-time polling -- fetch updates via stateless cursors; agent owns {pts, qts, date} state
Inline bots & buttons -- query inline bots, send results, press callback buttons
Stories -- read stories from peers, get story view stats; publish/edit/delete stories, react, pin, stealth mode, archive, report (v1.30.0)
Discussion -- get discussion-group info for channel posts with comments, list groups eligible for discussion (v1.30.0)
Read Receipts -- who read a message in a small group, when your private message was read (v1.30.0)
Admin controls -- toggle channel signatures, anti-spam, forum mode, prehistory; approve join requests
Stats -- channel and supergroup analytics (GetBroadcastStats / GetMegagroupStats)
Boosts & Business -- boost status, boosters list, Telegram Business chat links CRUD, work hours, location, greeting/away/intro messages
Star gifts -- browse available and saved gifts, save/convert gifts, manage Stars balance and subscriptions (opt-in via MCP_TELEGRAM_ENABLE_STARS=1, v1.34.0)
Shared daemon -- one background process serves multiple MCP clients over a single Telegram session; see the shared-daemon guide (v1.38.0)
QR code login -- authenticate by scanning a QR code in the Telegram app
Session persistence -- login once, stay connected across restarts
Human-readable output -- sender names are resolved, not just numeric IDs
Works with any MCP client -- Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Mastra, etc.

Prerequisites

Node.js 18 or later
Telegram API credentials -- API_ID and API_HASH from my.telegram.org

Quick Start

1. Get Telegram API credentials

Go to my.telegram.org and log in with your phone number.
Navigate to API development tools.
Create a new application (any name and platform).
Copy the App api_id and App api_hash.

2. Login

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH npx @overpod/mcp-telegram login

A QR code will appear in the terminal. Open Telegram on your phone, go to Settings > Devices > Link Desktop Device, and scan the code. The session is saved to ~/.mcp-telegram/session and reused automatically.

Custom session path: set TELEGRAM_SESSION_PATH=/path/to/session to store the session file elsewhere.

Two-step verification (2FA): if your account has a cloud password enabled, scanning the QR code is not enough — Telegram also requires the password. Provide it via TELEGRAM_2FA_PASSWORD so the login can complete:

`bash

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH TELEGRAM_2FA_PASSWORD=YOUR_PASSWORD npx @overpod/mcp-telegram login

`

The password is only used locally to answer Telegram's SRP challenge and is never persisted.

Local files: tools that upload a file (telegram-send-file, telegram-send-voice, telegram-send-album, stories, profile and group photos) read files under your home folder and temp folders, and downloads are saved to Downloads, Desktop, Documents or temp folders. Hidden files and folders (~/.ssh, ~/.mcp-telegram, ...), ~/Library, ~/AppData and the session file are always refused, and an existing file is never overwritten (name (1).ext is used). To use other folders, list them in MCP_TELEGRAM_FILE_DIRS (separated by :, or ; on Windows); this replaces the defaults.

3. Add to Claude

claude mcp add telegram -s user \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -- npx @overpod/mcp-telegram

That's it! Ask Claude to run telegram-status to verify.

Multiple Accounts

Use TELEGRAM_SESSION_PATH to run separate Telegram accounts side by side:

# Login each account with a unique session path

TELEGRAM_API_ID=ID1 TELEGRAM_API_HASH=HASH1 TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-work npx @overpod/mcp-telegram login TELEGRAM_API_ID=ID2 TELEGRAM_API_HASH=HASH2 TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-personal npx @overpod/mcp-telegram login

Then add each as a separate MCP server:

claude mcp add telegram-work -s user \

-e TELEGRAM_API_ID=ID1 \ -e TELEGRAM_API_HASH=HASH1 \ -e TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-work \ -- npx @overpod/mcp-telegram

claude mcp add telegram-personal -s user \ -e TELEGRAM_API_ID=ID2 \ -e TELEGRAM_API_HASH=HASH2 \ -e TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-personal \ -- npx @overpod/mcp-telegram

Each account gets its own session file — no conflicts.

Multiple agents / concurrent clients (shared daemon)

The opposite of multiple accounts: one account driven by many clients at once — several Claude Code windows, parallel sub-agents, or multiple IDEs. Normally each process opens the same session and they evict one another with AUTH_KEY_DUPLICATED. Serve mode fixes this.

Run a single persistent daemon that owns the one Telegram connection. Every other process auto-detects the daemon (via a PID lock) and becomes a thin client that proxies tool calls to it over a local Unix socket:

# On the host, once: start the daemon (owns the connection, no stdio)

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH mcp-telegram serve

(or set MCP_TELEGRAM_DAEMON=1 instead of the `serve` argument)

Then point each MCP client at the same install with the same TELEGRAM_SESSION_PATH — no serve argument. They connect to the daemon automatically; closing any client never drops the shared connection. Credentials are only required by the daemon (the owner), so client commands can omit TELEGRAM_API_ID/TELEGRAM_API_HASH and keep them where the daemon runs.

See the [shared daemon guide](docs/guides/shared-daemon.md) for a systemd unit and SSH usage.

Proxy Support

If Telegram is blocked or you're running in a containerized environment (Docker, K3s), use a SOCKS5 or MTProxy:

# SOCKS5 proxy

TELEGRAM_PROXY_IP=127.0.0.1 \ TELEGRAM_PROXY_PORT=10808 \ npx @overpod/mcp-telegram

MTProxy

TELEGRAM_PROXY_IP=proxy.example.com \ TELEGRAM_PROXY_PORT=443 \ TELEGRAM_PROXY_SECRET=ee00000000000000000000000000000000 \ npx @overpod/mcp-telegram

Variable	Description
`TELEGRAM_PROXY_IP`	Proxy server address
`TELEGRAM_PROXY_PORT`	Proxy server port
`TELEGRAM_PROXY_SOCKS_TYPE`	`4` or `5` (default: `5`)
`TELEGRAM_PROXY_SECRET`	MTProxy secret (enables MTProxy mode)
`TELEGRAM_PROXY_USERNAME`	Optional proxy auth
`TELEGRAM_PROXY_PASSWORD`	Optional proxy auth

Connecting via WSS (port 443)

If your VPS or hosting IP is reachable on outbound port 443 but not the default MTProto port 80 (some cloud providers ban port 80 on Telegram DC IP ranges as anti-abuse policy), set:

TELEGRAM_USE_WSS=true npx @overpod/mcp-telegram

Variable	Description
`TELEGRAM_USE_WSS`	When `true`, gramJS uses port `443` instead of `80` for the MTProto TCPFull transport. Default: `false`. Cannot be combined with `TELEGRAM_PROXY_*` (gramJS limitation) — if both are set, `useWSS` is ignored and the proxy takes precedence (a warning is logged).

Installation Options

npx (recommended, zero install)

No need to clone or install anything. Just use npx @overpod/mcp-telegram.

Global install

npm install -g @overpod/mcp-telegram

mcp-telegram # run server mcp-telegram login # QR login

Pre-built binary (no runtime needed)

Download from Releases — standalone single-file binaries, zero dependencies:

Platform	Server	Login CLI
Linux x64	`mcp-telegram-linux-x64`	`mcp-telegram-login-linux-x64`
Linux ARM64	`mcp-telegram-linux-arm64`	`mcp-telegram-login-linux-arm64`
macOS x64	`mcp-telegram-darwin-x64`	`mcp-telegram-login-darwin-x64`
macOS ARM64	`mcp-telegram-darwin-arm64`	`mcp-telegram-login-darwin-arm64`
Windows x64	`mcp-telegram-windows-x64.exe`	`mcp-telegram-login-windows-x64.exe`

# Download (example for Linux x64)

curl -L -o mcp-telegram https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-linux-x64 curl -L -o mcp-telegram-login https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-login-linux-x64 chmod +x mcp-telegram mcp-telegram-login

Login

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH ./mcp-telegram-login

Run

./mcp-telegram

From source

git clone https://github.com/mcp-telegram/mcp-telegram.git

cd mcp-telegram npm install && npm run build

Docker

docker build -t mcp-telegram https://github.com/mcp-telegram/mcp-telegram.git

docker run -it --rm \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -v ~/.mcp-telegram:/root/.mcp-telegram \ --entrypoint node mcp-telegram dist/qr-login-cli.js

Run the MCP server:

docker run -i --rm \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -v ~/.mcp-telegram:/root/.mcp-telegram \ mcp-telegram

Note: Login must be done once via terminal. After that, the session is persisted in ~/.mcp-telegram and reused a

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Chatroost — unofficial Telegram MCP server

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Chat & E-Maili

Häufige Fragen

Alternativen

Vexa

emailmd

MCP WhatsApp Cloud

README vom Entwickler

Telegram MCP Server

Features

Prerequisites

Quick Start

1. Get Telegram API credentials

2. Login

3. Add to Claude

Multiple Accounts

Multiple agents / concurrent clients (shared daemon)

(or set MCP_TELEGRAM_DAEMON=1 instead of the serve argument)

Proxy Support

MTProxy

Connecting via WSS (port 443)

Installation Options

npx (recommended, zero install)

Global install

Pre-built binary (no runtime needed)

Login

Run

From source

Docker

(or set MCP_TELEGRAM_DAEMON=1 instead of the `serve` argument)