Telegram MCP Server
About
A Model Context Protocol (MCP) server that enables LLMs to send notifications via Telegram and receive user responses. It integrates with Cline and other MCP‑compatible LLM applications.
Details
- Author
- MobileVibe
- Downloads
- 167
- Categories
- Communication
Jump to
- Send text notifications to a Telegram chat
- Customizable urgency levels: low, medium, high
- Wait for and retrieve user responses
- Supports both standalone and application‑integrated operation
- Works with Node.js 16 or higher
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Telegram MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package globally from npm (npm install -g telegram-mcp), set the required environment variables TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID, then run telegram-mcp. Alternatively, clone the repository, build, and run. For integration with Cline or Claude Desktop, add a JSON entry to their MCP settings or config file specifying the command, args, and environment variables.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"telegram mcp server": {
"telegram-mcp-mobilevibe": {
"command": "node",
"args": [
"examples/programmatic-usage.js"
]
}
}
}
}McpServers
{
"telegram-mcp-mobilevibe": {
"command": "node",
"args": [
"examples/programmatic-usage.js"
]
}
}Telegram MCP Server
A Model Context Protocol (MCP) server that enables LLMs to send notifications via Telegram and receive user responses.
Features
- Send text notifications to a Telegram chat with customizable urgency levels
- Wait for and retrieve user responses
- Integrates with Cline and other MCP-compatible LLM applications
Prerequisites
- Node.js 16 or higher
- A Telegram bot token (obtained from @BotFather)
- Your Telegram chat ID
Installation
From npm (recommended)
npm install -g telegram-mcp
From GitHub
git clone https://github.com/CHarrisTech/telegram-mcp.git
cd telegram-mcp
npm install
npm run build
Configuration
The server requires two environment variables:
- TELEGRAM_BOT_TOKEN: Your Telegram bot token
- TELEGRAM_CHAT_ID: Your Telegram chat ID
Getting a Telegram Bot Token
1. Start a chat with @BotFather on Telegram
2. Send the command /newbot
3. Follow the instructions to create a new bot
4. BotFather will provide you with a token for your new bot
Finding Your Chat ID
1. Start a chat with your new bot
2. Send a message to the bot
3. Visit https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
4. Look for the chat object in the response and note the id field
Usage
Running Standalone
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
