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
- License
- MIT license
Explore
- 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
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
- Node.js 16 or higher
- A Telegram bot token (obtained from @BotFather)
- Your Telegram chat ID
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
```bash
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHAT_ID="your_chat_id"
npm install
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHAT_ID="your_chat_id"
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"
]
}
}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.
