Telegram MCP Server

Telegram MCP Server ist ein von overpod gepflegtes Community-Projekt, das Telegram über das Model Context Protocol für KI-Agenten wie Claude oder ChatGPT zugänglich macht. Es ist kein offizielles Telegram-Produkt; Telegram selbst ist an Entwicklung oder Betrieb nicht beteiligt. Die offizielle Produktseite ist https://mcp-telegram.com, das Repository https://github.com/mcp-telegram/mcp-telegram enthält Quellcode, Lizenz und README. Laut Anbieter ist es der funktionsreichste verfügbare Telegram-MCP-Server mit 181 Werkzeugen.

MTProto statt Bot-API

Anders als viele Telegram-Integrationen nutzt der Server nicht die eingeschränkte Bot-API, sondern das umfassendere MTProto-Protokoll über die Bibliothek GramJS. Das bedeutet: Der Server läuft als sogenannter Userbot und agiert im Namen des persönlichen Telegram-Kontos der Person, die ihn einrichtet - nicht als separater Bot-Account und nicht mit dem Konto von Skill Road oder Dritten. Dadurch erhält ein Agent grundsätzlich Zugriff auf denselben Umfang an Chats, Kontakten und Nachrichtenverlauf, den auch der Kontoinhaber in der Telegram-App sieht.

Funktionsumfang

Laut README deckt der Server unter anderem Nachrichten, Medien, Reaktionen, Umfragen, geplante Nachrichten, Sticker, Kontakt- und Profilverwaltung, Foren-Themen, Chat-Ordner, globale Suche über alle Chats, Inline-Bots und Buttons, Stories, Leseempfangsstatus, Admin-Funktionen für Kanäle und Gruppen sowie Kanal-/Gruppen-Statistiken ab. Ein gemeinsamer Hintergrunddienst kann laut Anbieter mehrere MCP-Clients über eine einzige Telegram-Sitzung bedienen.

Einrichtung: selbst hosten oder Cloud-Version

Für den Self-Hosting-Weg wird der Server per npx gestartet; erforderlich sind eigene Telegram-API-Zugangsdaten (API_ID und API_HASH) von my.telegram.org sowie ein einmaliger Login per QR-Code, dessen Sitzung anschließend lokal gespeichert wird. Alternativ bietet der Anbieter unter mcp-telegram.com eine gehostete Cloud-Version an, die laut Beschreibung ohne eigene API-Schlüssel und mit QR-Code-Login in kurzer Zeit einsatzbereit ist. Skill Road listet ausschließlich den Katalogeintrag mit Verweis auf beide offiziellen Wege; installiert wird ausschließlich über die verlinkten Anbieterquellen.

Rechte, Datenzugriff und Sicherheitsgrenzen

Weil der Server als Userbot mit dem vollen Kontozugriff der einrichtenden Person läuft, sollte der Einsatzbereich vorab klar begrenzt werden. Ein kompromittiertes Session-Token erlaubt potenziell Lesen und Schreiben in allen für dieses Konto sichtbaren Chats, Kontakten und Kanälen. Zugangsdaten und Sitzungsdateien gehören ausschließlich in sichere, lokale Speicherorte oder Umgebungsvariablen, niemals in Prompts, Commits oder öffentlich zugängliche Konfigurationsdateien. Für sensible Business-Funktionen wie Stars-Guthaben ist laut README ein separates Opt-in per Umgebungsvariable nötig, was zusätzliche versehentliche Aktivierung verhindert.

Lizenz, GitHub-Sterne und Einordnung

Das Repository steht unter der MIT-Lizenz. Die GitHub-API meldete am 07.09.2026 exakt 42 Sterne; diese Zahl ist eine Momentaufnahme der Repository-Popularität und kein Beleg für Sicherheit, Qualität oder langfristige Pflege. Der Server selbst ist quelloffen und kostenlos nutzbar; für die Cloud-Version können je nach Anbieter-Tarif unterschiedliche Konditionen gelten, weshalb dieser öffentliche Eintrag keine festen Preise nennt. Die Kategorie Messaging & Kommunikation passt, weil der Server Chat-Inhalte, Kontakte und Nachrichtenaktionen für Agenten zugänglich macht.

Ein sinnvoller erster Test ist ein Zweitkonto oder ein eng begrenzter Anwendungsfall, etwa das Zusammenfassen eines einzelnen Kanals, bevor der volle Kontozugriff für produktive Automatisierung genutzt wird.

Node.js 18 oder neuer, eigenes Telegram-Konto sowie entweder Telegram-API-Zugangsdaten (API_ID/API_HASH) für Self-Hosting oder ein Konto bei der gehosteten Cloud-Version.

Für Self-Hosting npx @overpod/mcp-telegram login mit eigenen API_ID/API_HASH ausführen und per QR-Code anmelden, alternativ die gehostete Cloud-Version unter mcp-telegram.com nutzen.

npx @overpod/mcp-telegram login

QR-Code-Login mit dem eigenen Telegram-Konto; Self-Hosting benötigt zusätzlich API_ID und API_HASH von my.telegram.org, die Sitzung wird lokal gespeichert.

Der Server agiert als Userbot mit dem vollen Zugriffsumfang des verbundenen persönlichen Telegram-Kontos, einschließlich Chats, Kontakten und Nachrichtenverlauf.

Werkzeugaufrufe greifen über MTProto auf Telegram-Chats, Medien und Kontodaten des verbundenen Kontos zu und geben Ergebnisse an den MCP-Client zurück.

Als Community-Projekt ohne Telegram-Beteiligung agiert der Server bei kompromittierter Sitzung mit dem vollen Zugriffsumfang des Kontoinhabers; Session-Dateien und API-Zugangsdaten gehören ausschließlich in sichere, lokale Speicherorte.