Telegram MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_API_ID | Yes | From my.telegram.org | |
| TELEGRAM_SESSION | Yes | Generated via npm run auth | |
| TELEGRAM_API_HASH | Yes | From my.telegram.org |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_chatsA | List your Telegram chats, channels, and groups. Returns chat name, ID, type, and unread count. |
| read_messagesB | Read messages from a Telegram chat, channel, or group. Use a chat ID (from list_chats) or @username. |
| search_messagesB | Search for messages across all Telegram chats or within a specific chat. |
| get_chat_infoC | Get detailed information about a Telegram chat, channel, or group. |
| send_messageB | Send a message to a Telegram chat, channel, or group. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clear, non-overlapping purpose: listing chats, reading messages, searching, getting chat info, and sending messages. No ambiguity in tool selection.
All tool names follow a consistent verb_noun pattern (e.g., list_chats, read_messages, send_message), making them predictable and easy to understand.
With five tools, the server covers the core messaging actions without being too sparse or too heavy. Each tool serves a distinct and necessary function.
The tool set supports basic reading, searching, and sending text messages, but lacks critical operations like sending media, editing or deleting messages, and managing chats. This is a notable gap for a full-featured messaging server.