MCP Communicator (Telegram)

What is MCP Communicator (Telegram)?

MCP Communicator (Telegram) is an MCP server that enables communication with users through Telegram. It provides tools to interact with users via a Telegram bot, including asking questions, sending notifications, sharing files, and creating project archives. It is designed for developers using the Model Context Protocol who need to integrate Telegram-based interactions into their MCP workflows.

How to use MCP Communicator (Telegram)?

Install the server globally (npm install -g mcp-communicator-telegram) or run on demand (npx mcptelegram). Obtain a Telegram bot token from @BotFather and your chat ID using the included utility (npx mcptelegram-chatid). Configure the TELEGRAM_TOKEN and CHAT_ID environment variables, then add the server to your MCP settings file. Use the provided tools (e.g., ask_user, notify_user, send_file, zip_project) to interact with the user.

Key features of MCP Communicator (Telegram)

• Ask questions to users through Telegram and wait for a response.
• Send notifications to users (no response required).
• Send files to users via Telegram.
• Create and send project zip files (respects .gitignore).
• Receive responses asynchronously (waits indefinitely for a reply).
• Secure chat ID validation and environment variable configuration.

Use cases of MCP Communicator (Telegram)

• Asking a user for input during an automated MCP workflow.
• Sending real-time notifications about task completion or errors.
• Sharing generated files or artifacts with the user.
• Creating and sending a compressed archive of a project directory.

FAQ from MCP Communicator (Telegram)

What are the prerequisites for using MCP Communicator (Telegram)?

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

How do I get my Telegram chat ID?

Run the included utility: npx mcptelegram-chatid. After sending any message to your bot, the chat ID will be printed to the console.

What tools does MCP Communicator (Telegram) provide?

Four tools: ask_user (asks a question and waits for a response), notify_user (sends a one-way message), send_file (sends a file), and zip_project (creates a zip archive of a directory, respecting .gitignore, and sends it).

How does the server handle security and message tracking?

The server only responds to messages from the configured chat ID. Message IDs are used to track question/answer pairs, and the bot ignores messages without proper context. Sensitive configuration uses environment variables.

What are the file size limits for sending files?

The server can handle files up to 2GB in size.