Loading...
This MCP server bridges AI assistants with the Telegram API, enabling message management, organization, and communication, but requires careful API key management.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
This MCP server bridges AI assistants with the Telegram API, enabling message management, organization, and communication, but requires careful API key management.
This server offers useful Telegram integration, but the ability to send messages introduces risk. It's relatively safe for read-only operations, but sending messages requires careful prompt engineering and monitoring to prevent unintended actions. Secure storage of API keys is crucial.
Performance depends on the Telegram API's responsiveness and the size of the dialogs being processed. Large dialogs may take longer to retrieve and analyze.
Consider Telegram API usage costs, if any, and the computational resources required to run the server.
npx -y @chaindead/telegram-mcp{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "@chaindead/telegram-mcp"],
"env": {
"TG_APP_ID": "<your-api-id>",
"TG_API_HASH": "<your-api-hash>"
}
}
}
}tg_meRetrieves information about the current Telegram account.
Read-only operation, no side effects.
tg_dialogsLists Telegram dialogs, optionally filtering by unread status.
Read-only operation, no side effects.
tg_readMarks a specific Telegram dialog as read.
Modifies dialog state, but not destructive.
tg_dialogRetrieves messages from a specific Telegram dialog.
Read-only operation, no side effects.
tg_sendSends a draft message to a specified Telegram dialog.
Sends messages; potential for unintended communication.
API Key
This server offers useful Telegram integration, but the ability to send messages introduces risk. It's relatively safe for read-only operations, but sending messages requires careful prompt engineering and monitoring to prevent unintended actions. Secure storage of API keys is crucial.
Autonomy depends on the AI assistant's configuration and how it utilizes the available tools. Exercise caution when granting full autonomy, especially with message sending capabilities.
Production Tip
Monitor Telegram API usage to avoid rate limits and potential account restrictions.
The server requires read and write access to your Telegram account to retrieve dialogs, messages, and send messages.
Treat your API ID and hash like a password. Store them securely and avoid committing them to public repositories.
Each instance of the server is configured for a single Telegram account. Running multiple instances may be possible, but requires separate configurations.
The server may experience errors or temporary disruptions. Implement rate limiting and error handling in your AI assistant to mitigate this.
No, this server interacts with the Telegram API, which does not provide end-to-end encryption for all message types.
Use the appropriate installation method (Homebrew, NPX, or manual download) to update to the latest release.
No, the current version of the server does not support message deletion.