MCP.so
Sign In

Telegram MCP Server

@MobileVibe

Repository

About Telegram MCP Server

MCP server to send notifications to Telegram

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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](https://t.me/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`.

Comments

Basic information

Category

Communication

License

MIT license

Transports

stdio

Author

MobileVibe

More Communication MCP servers

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

Gmail

shinzo-labs

MCP Implementation for Gmail Services

56

Discord MCP Server

hanweg

MCP server for discord bot

161

MCP Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383

MCP Email Server

Shy2593666979

一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。

78