Telegram MCP server
The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.
[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.
Table of Contents
- What is MCP?
- What does this server do?
- Capabilities
- Prompt examples
- Message Management
- Organization
- Communication
- Installation
- Homebrew
- NPX
- From Releases
- MacOS
- Linux
- Windows
- From Source
- Configuration
- Authorization
- Client Configuration
- JSON Schema Version
- Star History
What is MCP?
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
What does this server do?
Capabilities
- Get current account information (
tool: tg_me) - List dialogs with optional unread filter (
tool: tg_dialogs) - Mark dialog as read (
tool: tg_read) - Retrieve messages from specific dialog (
tool: tg_dialog) - Send draft messages to any dialog (
tool: tg_send)
