Telegram Mcp Server
What is Telegram Mcp Server
The telegram-mcp-server is a Model Context Protocol server designed for the Telegram Bot API, enabling AI assistants to interact with Telegram using standardized tools.
Use cases
Use cases include sending automated messages to users, sharing images in chats, and managing chat content by deleting messages as needed.
How to use
To use the telegram-mcp-server, install the necessary dependencies, create a .env file with your Telegram Bot Token, build the TypeScript project, and start the server. Additionally, configure your MCP client to connect to the server.
Key features
Key features include support for sending messages, sending photos with captions, and deleting messages from chats. It utilizes the Model Context Protocol SDK and the Telegram Bot API.
Where to use
The telegram-mcp-server can be used in various domains where Telegram bots are needed, such as customer support, automated notifications, and interactive AI applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Telegram Mcp Server
The telegram-mcp-server is a Model Context Protocol server designed for the Telegram Bot API, enabling AI assistants to interact with Telegram using standardized tools.
Use cases
Use cases include sending automated messages to users, sharing images in chats, and managing chat content by deleting messages as needed.
How to use
To use the telegram-mcp-server, install the necessary dependencies, create a .env file with your Telegram Bot Token, build the TypeScript project, and start the server. Additionally, configure your MCP client to connect to the server.
Key features
Key features include support for sending messages, sending photos with captions, and deleting messages from chats. It utilizes the Model Context Protocol SDK and the Telegram Bot API.
Where to use
The telegram-mcp-server can be used in various domains where Telegram bots are needed, such as customer support, automated notifications, and interactive AI applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Telegram MCP Server
A Model Context Protocol server for the Telegram Bot API, allowing AI assistants to interact with Telegram using standardized tools.
Setup
-
Install dependencies:
npm install -
Create a
.envfile with your Telegram Bot Token:TELEGRAM_BOT_TOKEN=your_bot_token_here -
Build the TypeScript project:
npm run build -
Start the server:
npm start
MCP Client Configuration
To use this server with an MCP client, add the following configuration to your MCP client’s config file:
{
"mcpServers": {
"telegram": {
"command": "node",
"args": [
"path/to/telegram-mcp-server/dist/telegram-mcp.js"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your_bot_token_here"
}
}
}
}Supported Operations
The Telegram MCP server supports the following operations:
- sendMessage: Send a text message to a chat
- sendPhoto: Send a photo with optional caption to a chat
- deleteMessage: Delete a message from a chat
Usage Example
The server implements the Model Context Protocol, so it can be used with any MCP-compatible client. Here are some example call formats:
Send a message :
{
"operation": "sendMessage",
"chatId": 123456789,
"text": "Hello from the Telegram MCP Server!"
}Send a photo :
{
"operation": "sendPhoto",
"chatId": 123456789,
"photoUrl": "https://example.com/image.jpg",
"caption": "Check out this photo!"
}Delete a message :
{
"operation": "deleteMessage",
"chatId": 123456789,
"messageId": 987654321
}Implementation Details
This server uses:
- The Model Context Protocol SDK
- Telegram Bot API
- TypeScript
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
