Telegram Pager MCP Server
This server provides a single, focused capability: sending direct Telegram messages via your personal Telegram account using the send_telegram_message tool.
Specify the recipient's Telegram username (without
@) and the message content to send them a direct message.Designed as a "pager" for notifications or alerts (e.g., notifying yourself when a build finishes).
What you cannot do:
Read chat history
Delete messages
View contacts
Perform any other Telegram account actions
Allows sending direct messages via a personal Telegram account.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Telegram Pager MCP Server Send a message to 'john_doe' saying 'Task completed successfully'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Telegram Pager MCP Server
A specialized Model Context Protocol (MCP) server that allows AI coding assistants (like Cursor, Cline, or Claude Desktop) to send direct messages via your personal Telegram account.
Security First: This server exposes exactly one tool (send_telegram_message). It is intentionally designed as a "Telegram Pager", meaning the AI cannot read your chat history, delete messages, or view your contacts.
Do NOT use this tool for spam. If you configure an AI agent to send unsolicited messages, bulk broadcasts, or promotional content using this server, Telegram's automated systems will quickly flag your activity. Your personal Telegram account will be permanently banned and your phone number blocked. Use this exclusively for personal notifications or messaging your own contacts responsibly.
Prerequisites
To use this, you need a Telegram API ID and Hash.
Log in to my.telegram.org/apps.
Create an application (if you haven't already).
Copy your
App api_idandApp api_hash.
Related MCP server: Telegram MCP Server
Installation & Setup
Install the package:
pipx install mcp-server-telegram-pagerGenerate your Session String: Because Telegram requires 2FA (a login code sent to your app), you must generate an authentication session string locally first.
mcp-server-telegram-pager-authFollow the prompts to enter your API ID, Hash, and Login Code. Copy the long session string it outputs!
Configuring your MCP Client
Add the following to your IDE's MCP configuration file (e.g., in Cursor or Claude Desktop):
{
"mcpServers": {
"telegram-pager": {
"command": "mcp-server-telegram-pager",
"env": {
"TELEGRAM_API_ID": "YOUR_API_ID_HERE",
"TELEGRAM_API_HASH": "YOUR_API_HASH_HERE",
"TELEGRAM_SESSION": "YOUR_LONG_SESSION_STRING_HERE"
}
}
}
}How to Test
Once configured, you can ask your AI assistant:
"Send a Telegram message to username 'coolperson123' saying 'The build finished successfully!'"
(Note: Do not include the @ symbol in the username).
Available Tools
1 toolsend_telegram_messageB
Send a direct message to a Telegram user. Do not use the @ symbol in the username (e.g. use 'jakethesnake', not '@jakethesnake').
Inputs: message (required), username (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusion between tools.
The single tool uses a clear verb_noun pattern (send_telegram_message), which is consistent and predictable.
One tool is borderline for the 'Telegram Pager' purpose; while it could be sufficient for a narrowly scoped paging server, it feels thin compared to typical server sizes.
The server only supports sending messages, lacking any other operations like checking delivery status or managing contacts, which are significant gaps for a Telegram integration.
Related MCP Connectors
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that integrates with Discord to provide AI-powered features.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- AlicenseAqualityDmaintenanceA streamlined MCP server designed to send AI agent progress updates, images, and files directly to a user via Telegram. It allows users to monitor long-running tasks and receive notifications or build artifacts through a simple messaging interface.3255 npm7MIT
- FlicenseAqualityDmaintenanceAn MCP server for interacting with Telegram bots and channels using the Telegraf library. It allows AI agents to send messages, manage channels, forward content, and intelligently respond to Telegram conversations.58-
- AlicenseNot gradedqualityDmaintenanceAn MCP server enabling AI agents to interact with users via Telegram, supporting message and image sending, inline quick replies, and waiting for user responses.5 npmMIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server for sending and receiving Telegram messages via a bot, enabling AI assistants to interact directly through Telegram by sending messages, reading recent messages, and sending photos.-