MCP.so
Sign In

MCP Communicator (Telegram)

@qpd-v

Repository

About MCP Communicator (Telegram)

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.

#telegram#mcp-communicator#communication-bot

Basic information

Category

Communication

Runtime

node

Transports

stdio

Publisher

qpd-v

Config

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

{
  "mcpServers": {
    "mcp-communicator-telegram": {
      "command": "npx",
      "args": [
        "mcptelegram"
      ]
    }
  }
}

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 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.

Comments

More Communication MCP servers

Telegram MCP Server

chigwell

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

1.3K

Slack MCP Server

korotovsky

The most powerful MCP Slack Server with no permission requirements, Apps support, GovSlack, DMs, Group DMs and smart history fetch logic.

1.7K

PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

priyankark

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co

35

Gmail

shinzo-labs

MCP Implementation for Gmail Services

56

Telegram MCP Server

kfastov

Telegram user console client and archiver

40