telegram-mcp-server
If you are the rightful owner of telegram-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol server for the Telegram Bot API, allowing AI assistants to interact with Telegram using standardized tools.
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
