MCP Communicator (Telegram) MCP Server

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their

Local serverstdioTypeScript

What is the MCP Communicator (Telegram) MCP server?

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot. The mcp communicator (telegram) mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 4 defined tools rather than through you.

What it actually does

An MCP server that enables communication with users through Telegram. This server provides tools to interact with users via a Telegram bot, including asking questions, sending notifications, sharing files, and creating project archives.

  • Ask questions to users through Telegram
  • Send notifications to users (no response required)
  • Send files to users via Telegram
  • Create and send project zip files (respecting .gitignore)
  • Receive responses asynchronously (waits indefinitely for response)
  • Support for reply-based message tracking

Adding it to your client

The server ships on npm as mcptelegram, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

Everything the assistant can do here goes through one of these:

  • ask_user — Asks a question to the user via Telegram and waits for their response
  • notify_user — Sends a notification message to the user via Telegram (no response required)
  • send_file — Input Schema: json { "type": "object", "properties": { "filePath": { "type": "string", "description": "The path to the file to send" } }, "required"
  • zip_project — Creates a zip file of a project directory (respecting .gitignore patterns) and sends it to the user via Telegram

Configuration

You will need 2 environment variables: TELEGRAM_TOKEN, CHAT_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js (v14 or higher) - A Telegram bot token (obtained from @BotFather) - Your Telegram chat ID (can be obtained using the included utility)

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp communicator (telegram) mcp server does with a few real requests.

When to reach for it

Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP Communicator (Telegram)'s toolset — ask_user, notify_user, send_file and 1 more — is a fair guide to whether it matches your workflow. It is maintained by qpd-v; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against MCP Communicator (Telegram)'s own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
ask_userAsks a question to the user via Telegram and waits for their response.
notify_userSends a notification message to the user via Telegram (no response required).
send_fileInput Schema: json { "type": "object", "properties": { "filePath": { "type": "string", "description": "The path to the file to send" } }, "required": ["filePath"] }
zip_projectCreates a zip file of a project directory (respecting .gitignore patterns) and sends it to the user via Telegram.

How to install the MCP Communicator (Telegram) MCP server

{
  "mcpServers": {
    "communicator-telegram": {
      "command": "npx",
      "args": ["-y", "mcptelegram"],
      "env": {
        "TELEGRAM_TOKEN": "your-value",
        "CHAT_ID": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js (v14 or higher) - A Telegram bot token (obtained from @BotFather) - Your Telegram chat ID (can be obtained using the included utility)
VariableDescriptionRequired
TELEGRAM_TOKENCredential the server authenticates with.Yes
CHAT_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP Communicator (Telegram) to ask user.
  • Use MCP Communicator (Telegram) to notify user.
  • Use MCP Communicator (Telegram) to send file.

Frequently asked questions

Node.js version 14 or higher, a Telegram bot token (obtained from [@BotFather](https://t.me/botfather)), and your personal Telegram chat ID.