Telegram MCP Server

Name: Telegram MCP Server
Author: MobileVibe

@MobileVibe

リポジトリ

Telegram MCP Server について

MCP server to send notifications to Telegram

基本情報

カテゴリ

コミュニケーション

ライセンス

MIT license

ランタイム

node

トランスポート

stdio

公開者

MobileVibe

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "telegram-mcp-mobilevibe": {
      "command": "node",
      "args": [
        "examples/programmatic-usage.js"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Telegram MCP Server?

A Model Context Protocol (MCP) server that enables LLMs to send notifications via Telegram and receive user responses. It integrates with Cline and other MCP‑compatible LLM applications.

How to use Telegram MCP Server?

Install the package globally from npm (npm install -g telegram-mcp), set the required environment variables TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID, then run telegram-mcp. Alternatively, clone the repository, build, and run. For integration with Cline or Claude Desktop, add a JSON entry to their MCP settings or config file specifying the command, args, and environment variables.

Key features of Telegram MCP Server

Send text notifications to a Telegram chat
Customizable urgency levels: low, medium, high
Wait for and retrieve user responses
Supports both standalone and application‑integrated operation
Works with Node.js 16 or higher

Use cases of Telegram MCP Server

LLM notifies a user about task completion or requests approval
LLM waits for a user’s answer before proceeding with an action
Integrating LLMs into Telegram‑based workflow automation

FAQ from Telegram MCP Server

What prerequisites are needed to run the server?

Node.js 16 or higher, a Telegram bot token (obtained from @BotFather), and your Telegram chat ID.

How do I get a Telegram bot token?

Start a chat with @BotFather on Telegram, send the command /newbot, follow the instructions, and BotFather will provide a token.

How do I find my Telegram chat ID?

Start a chat with your new bot, send a message, then visit https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates. Look for the chat object in the response and note the id field.

What tools does the server provide?

Two tools: send_notification (sends a message with optional urgency) and check_notification_response (checks for a user reply to a previous message, with an optional timeout).

How do I integrate the server with Cline or Claude Desktop?

Add a JSON entry to the MCP settings file (Cline) or config file (Claude Desktop) under mcpServers, specifying command: "node", args pointing to the built index.js, and env containing TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID.