qpd-v/mcp-communicator-telegram

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.
## Installation
### Via npm (global)
bash
npm install -g mcp-communicator-telegram
### Via npx (on-demand)
bash
npx mcptelegram
To get your Telegram chat ID:
bash
npx mcptelegram-chatid
## Features
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
Secure chat ID validation
Error handling and logging
## Prerequisites
Node.js (v14 or higher)
A Telegram bot token (obtained from @BotFather)
Your Telegram chat ID (can be obtained using the included utility)
## Installation
1. Clone the repository:
bash
git clone https://github.com/qpd-v/mcp-communicator-telegram.git
cd mcp-communicator-telegram
2. Install dependencies:
bash
npm install
3. Create a Telegram bot:
Open Telegram and search for @BotFather
Send /newbot and follow the instructions
Save the bot token you receive
4. Get your chat ID:
Copy .env.example to .env
Add your bot token to the .env file:
TELEGRAMTOKEN=yourbottokenhere
Run the chat ID utility:
bash
npm run build
node build/get-chat-id.js
Send any message to your bot
Copy the chat ID that appears in the console
Add the chat ID to your .env file:
TELEGRAMTOKEN=yourbottokenhere
CHATID=yourchatidhere
## Configuration
Add the server to your MCP settings file (usually located at %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\clinemcpsettings.json on Windows):
json
"mcpServers": {
"mcp-communicator-telegram": {
"command": "node",
"args": ["path/to/mcp-communicator-telegram/build/index.js"],
"env": {
"TELEGRAMTOKEN": "yourbottokenhere",
"CHATID": "yourchatidhere"
## Available Tools
### askuser
Asks a question to the user via Telegram and waits for their response.
Input Schema:
json
"type": "object",
"properties": {
"question": {
"type": "string",
"description": "The question to ask the user"
},
"required": ["question"]
Example usage:
typescript
const response = await usemcptool({
servername: "mcp-communicator-telegram",
toolname: "askuser",
arguments: {
question: "What is your favorite color?"
});
### notifyuser
Sends a notification message to the user via Telegram (no response required).
Input Schema:
json
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "The message to send to the user"
},
"required": ["message"]
Example usage:
typescript
await usemcptool({
servername: "mcp-communicator-telegram",
toolname: "notifyuser",
arguments: {
message: "Task completed successfully!"
});
### sendfile
Sends a file to the user via Telegram.
Input Schema:
json
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "The path to the file to send"
},