Telegram MCP Server
About
Telegram MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop to send Telegram messages. It provides a secure way for AI applications to interact with the Telegram Bot API through a simple tool.
Details
- Author
- jeroensmink98
- Downloads
- 329
- Categories
- Communication
Jump to
- Sends Telegram messages from AI assistants.
- Uses the Model Context Protocol (MCP).
- Configured via environment variables (TELEGRAM_TOKEN, CHAT_ID).
- Single tool with one required parameter.
- Built with Node.js and TypeScript.
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 dependencies with npm install, build with npm run build, then configure the Telegram bot token and chat ID via environment variables in your .cursor/mcp.json file. The server exposes one tool (send_telegram_message) that takes a message string as its only parameter.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"telegram mcp server": {
"telegram": {
"command": "node",
"args": [
"./dist/mcp-server.js"
],
"env": {
"TELEGRAM_TOKEN": "",
"CHAT_ID": ""
}
}
}
}
}McpServers
{
"telegram": {
"command": "node",
"args": [
"./dist/mcp-server.js"
],
"env": {
"TELEGRAM_TOKEN": "",
"CHAT_ID": ""
}
}
}Telegram MCP Server
This project implements a Model Context Protocol (MCP) server that enables sending Telegram messages through AI assistants like Claude Desktop.
What is MCP?
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
Setup
1. Install dependencies:
npm install
2. Build the project:
npm run build
Configuration
The server requires two environment variables to be set:
- TELEGRAM_TOKEN: Your Telegram Bot API token
- CHAT_ID: The ID of the Telegram chat where messages will be sent
These can be configured in your .cursor/mcp.json file:
{
"mcpServers": {
"telegram": {
"command": "node",
"args": ["./dist/mcp-server.js"],
"env": {
"TELEGRAM_TOKEN": "your-telegram-bot-token",
"CHAT_ID": "your-chat-id"
}
}
}
}
Available Tools
send_telegram_message
Sends a message to the configured Telegram chat.
Parameters:
- message (string): The message text to send
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
