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

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

Configuration

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

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.