Telegram MCP Server 0oe

🚀 Telegram MCP Server

This project implements a Model Context Protocol (MCP) server that allows sending Telegram messages via AI assistants such as Claude Desktop.

🚀 Quick Start

✨ Features

The Model Context Protocol (MCP) is a system that enables AI applications (e.g., Claude Desktop) to connect to external tools and services. It provides AI assistants with a clear and secure way to interact with local services and APIs while keeping users in control.

📦 Installation

1. Install dependencies:

npm install

2. Build the project:

npm run build

📚 Documentation

Configuration

The server requires the following two environment variables:

• TELEGRAM_TOKEN: Your Telegram Bot API token
• CHAT_ID: The Telegram chat ID to send messages to

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 text of the message to send.