Telegram

You can run a Telegram-based MCP server that talks to users, asks questions, sends notifications and files, and can package project archives for delivery. It’s designed to integrate with your MCP client workflow so you can interact with users directly through Telegram.

How to use

You interact with this MCP server from your MCP client by invoking its tools through the MCP interface. The main capabilities let you ask users questions, send notifications without awaiting a reply, deliver files, and zip project directories to share. Each tool returns results or confirmations that you can use in your automation flow. Use the standard MCP tool pattern to call the server by name, specify the tool you want (for example, ask_user, notify_user, send_file, or zip_project), and pass the required arguments. All interactions respect the configured Telegram chat ID and bot token, ensuring messages only come from your trusted chat.

How to install

# Prerequisites
- Node.js (v14 or higher)
- A Telegram bot token (from @BotFather)
- Your Telegram chat ID

# 1) Install the MCP Telegram communicator globally (optional)
npm install -g mcp-communicator-telegram

# 2) Or run on-demand with npx
npx mcptelegram

# 3) Prevent the need to fetch chat id separately
npx mcptelegram-chatid

# 4) If you prefer to clone the project and run locally
git clone https://github.com/qpd-v/mcp-communicator-telegram.git
cd mcp-communicator-telegram

# 5) Install dependencies
npm install

# 6) Create a Telegram bot and obtain the token from BotFather
# 7) Obtain chat ID by sending a message to your bot and using the chat-id utility

Configuration

{
  "mcpServers": {
    "mcp-communicator-telegram": {
      "command": "node",
      "args": ["path/to/mcp-communicator-telegram/build/index.js"],
      "env": {
        "TELEGRAM_TOKEN": "your_bot_token_here",
        "CHAT_ID": "your_chat_id_here"
      }
    }
  }
}

Security

The server only responds to messages from the configured chat ID. Environment variables are used for sensitive configuration, and message tracking uses IDs to correlate questions and answers. Messages without proper context are ignored to protect your workflow.

Development

To build and run the project in development mode, use the following commands to compile, run, and watch for changes.

npm run build
npm run dev
npm run watch

Notes

The server supports several tools for interacting with users through Telegram. You install and configure the server by adding it to your MCP settings, then use the provided tools to interact with your Telegram bot and chat. The examples include how to ask users questions, send notifications, send files, and zip projects for delivery.

Available tools

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

Sends a file to the user via Telegram.

zip_project

Creates a zip file of a project directory (respecting .gitignore) and sends it via Telegram.