Skip to main content
Glama
Telegram Pager MCP Server

Telegram Pager MCP Server

by ashizam

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.

WARNING

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.

  1. Log in to my.telegram.org/apps.

  2. Create an application (if you haven't already).

  3. Copy your App api_id and App api_hash.

Related MCP server: Telegram MCP Server

Installation & Setup

  1. Install the package:

    pipx install mcp-server-telegram-pager
  2. Generate 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-auth

    Follow 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 tool
send_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

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion between tools.

    Naming Consistency5/5

    The single tool uses a clear verb_noun pattern (send_telegram_message), which is consistent and predictable.

    Tool Count3/5

    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.

    Completeness2/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      3
      255 npm
      7
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An 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.
      5
      8
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -