de en es ja ko ru zh

telegram-mcp-server

Name: telegram-mcp-server
Author: Steph-ux

by Steph-ux

Overview Schema Related Servers Score Discussions

Python

Remote

telegram-mcp-server

Ein Telegram-MCP-Server auf Basis von Telethon — persistenter Client, flood-sicher, 9 gruppierte Tools.

Null API-Schlüssel im Code. Sitzungsdateien werden lokal gespeichert. Funktioniert mit Benutzerkonten (2FA) und Bots.

1. Installation

git clone <this-repo> telegram-mcp-server
cd telegram-mcp-server

python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

pip install -e .

API-Anmeldedaten abrufen

Gehe zu my.telegram.org
Melde dich mit deiner Telefonnummer an
Erstelle eine App → erhalte API ID und API Hash

Einmalige Authentifizierung

# User account (with 2FA support)
export TG_API_ID=12345
export TG_API_HASH="your_hash_here"
telegram-mcp-server --auth --phone +33612345678

# Or via MCP tool: tg_session(action="auth", api_id=12345, api_hash="...", phone="+33612345678")

Related MCP server: tdlib-mcp-server

2. In deinem MCP-Client registrieren

Claude Desktop / OpenCode

{
  "mcpServers": {
    "telegram": {
      "command": "telegram-mcp-server",
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Falls nicht im PATH:

{
  "mcpServers": {
    "telegram": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "telegram_mcp_server"],
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Docker

docker build -t telegram-mcp .
docker run -i --rm \
  -v ~/.telegram-mcp/sessions:/root/.telegram-mcp/sessions \
  -e TG_API_ID=12345 \
  -e TG_API_HASH="your_hash" \
  telegram-mcp

3. Tool-Katalog (9 Tools, 8 Aktionen)

`tg_session` — Sitzungsverwaltung

Aktion	Erforderliche Argumente	Beschreibung
`auth`	`api_id`, `api_hash`, `phone` oder `bot_token`	Authentifizieren (2FA unterstützt)
`check`	—	Anmeldestatus prüfen
`logout`	—	Sitzung löschen

`tg_message` — Senden, weiterleiten, löschen, antworten

Aktion	Erforderliche Argumente	Beschreibung
`send`	`target`, `text`	Eine Nachricht senden
`forward`	`target`, `message_id`, `to_target`	Eine Nachricht weiterleiten
`delete`	`target`, `message_id`	Eine Nachricht löschen
`reply`	`target`, `message_id`, `text`	Auf eine Nachricht antworten

`tg_chat` — Chat-Operationen

Aktion	Erforderliche Argumente	Beschreibung
`list`	—	Letzte Chats auflisten
`info`	`target`	Chat-Informationen abrufen
`members`	`target`	Chat-Mitglieder auflisten
`leave`	`target`	Einen Chat verlassen

`tg_search` — Suche

Aktion	Erforderliche Argumente	Beschreibung
`messages`	`query`	Nachrichten suchen (optional in `target`)
`users`	`query`	Kontakte/Benutzer suchen
`channels`	`query`	Kanäle suchen

`tg_history` — Chat-Verlauf

Aktion	Erforderliche Argumente	Beschreibung
`messages`	`target`	Nachrichtenverlauf abrufen
`media`	`target`	Nur Medien-Verlauf abrufen
`files`	`target`	Nur Dateien-Verlauf abrufen

`tg_user` — Benutzer-Operationen

Aktion	Erforderliche Argumente	Beschreibung
`me`	—	Eigene Informationen abrufen
`info`	`target`	Benutzerinformationen abrufen
`block`	`target`	Einen Benutzer blockieren
`unblock`	`target`	Einen Benutzer entsperren

`tg_media` — Medien senden

Aktion	Erforderliche Argumente	Beschreibung
`send_photo`	`target`, `file_path`	Ein Foto senden
`send_video`	`target`, `file_path`	Ein Video senden
`send_file`	`target`, `file_path`	Ein Dokument senden
`send_voice`	`target`, `file_path`	Eine Sprachnachricht senden

`tg_channel` — Kanalverwaltung

Aktion	Erforderliche Argumente	Beschreibung
`create`	`title`	Eine Supergruppe/einen Kanal erstellen
`join`	`target`	Einem Kanal beitreten
`leave`	`target`	Einen Kanal verlassen
`info`	`target`	Kanalinformationen abrufen

`tg_draft` — Entwurfsnachrichten

Aktion	Erforderliche Argumente	Beschreibung
`save`	`target`, `text`	Einen Entwurf speichern
`list`	—	Alle Entwürfe auflisten
`delete`	`target`	Einen Entwurf löschen

4. Umgebungsvariablen

Variable	Standard	Beschreibung
`TG_API_ID`	`0`	Telegram-API-ID (von my.telegram.org)
`TG_API_HASH`	`""`	Telegram-API-Hash
`TG_SESSION_DIR`	`~/.telegram-mcp/sessions`	Speicherort der Sitzungsdateien

5. Sicherheit

Ratenbegrenzer: Sendeaktionen auf 5/Min. begrenzt. Leseaktionen unbegrenzt.
Automatische Wiederholung bei FloodWaitError: Wartet die erforderliche Zeit (begrenzt auf 5 Min.).
Sitzungsdateien: Nur lokal, niemals in git committet.
2FA-Unterstützung: Volle Unterstützung für Konten mit Zwei-Faktor-Authentifizierung.

6. MCP-Ressourcen

tg://version — Serverversion
tg://session/status — Anmeldestatus

Lizenz

MIT

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Telegram MCP Server
Communication Social Media
shaxzodrashid
F
license
A
quality
B
maintenance
Enables AI agents to interact with Telegram via MTProto, supporting high-performance communication and seamless integration.
Updated a month ago (2026-07-23 20:34 UTC)
1
tdlib-mcp-server
Communication Search
Crocodile-beep
F
license
Not graded
quality
C
maintenance
Connects AI agents to Telegram via the official TDLib library, enabling tools like getting user info, listing dialogs, and searching messages.
Updated 2 months ago (2026-06-08 16:35 UTC)
telegram-mcp
Communication
chenzhaoxuan0
A
license
Not graded
quality
C
maintenance
Enables interaction with Telegram Bot API for sending messages, photos, editing messages, answering callbacks, and fetching updates.
Updated 2 months ago (2026-06-18 07:53 UTC)
MIT
Telegram Bot MCP Server
Communication App Automation
mattleads
A
license
Not graded
quality
B
maintenance
Enables sending Telegram messages, photos, and documents, and retrieving bot information through the Telegram Bot API.
Updated 4 months ago (2026-04-08 19:58 UTC)
58
1
MIT

View all related MCP servers

Related MCP Connectors

fast-mcp-telegram
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
telegram-mcp
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
tgden — Telegram catalog & search
Search 1.2M+ Telegram channels, 245k+ chats, 160k+ bots — no account, no key, no install.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/telegram-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

telegram-mcp-server

1. Installation

API-Anmeldedaten abrufen

Einmalige Authentifizierung

2. In deinem MCP-Client registrieren

Claude Desktop / OpenCode

Docker

3. Tool-Katalog (9 Tools, 8 Aktionen)

tg_session — Sitzungsverwaltung

tg_message — Senden, weiterleiten, löschen, antworten

tg_chat — Chat-Operationen

tg_search — Suche

tg_history — Chat-Verlauf

tg_user — Benutzer-Operationen

tg_media — Medien senden

tg_channel — Kanalverwaltung

tg_draft — Entwurfsnachrichten

4. Umgebungsvariablen

5. Sicherheit

6. MCP-Ressourcen

Lizenz

Maintenance

Resources

Looking for Admin?

Related MCP Servers