Telegram MCP Server

What is Telegram MCP Server?

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.

How to use Telegram MCP Server?

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.

Key features of Telegram MCP Server

• 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.

Use cases of Telegram MCP Server

• Send notifications or alerts from an AI assistant to a Telegram chat.
• Allow Claude Desktop to post updates or messages to a group or channel.
• Integrate AI-powered workflows with Telegram messaging.

FAQ from Telegram MCP Server

What is MCP and how does this server fit in?

The Model Context Protocol (MCP) lets AI apps like Claude Desktop connect to external tools. This server implements MCP so that an AI assistant can call the send_telegram_message tool to post messages to Telegram.

What are the required dependencies and runtime?

Node.js and npm are needed. The Telegram bot token (TELEGRAM_TOKEN) and the target chat ID (CHAT_ID) must be set as environment variables.

Where is the configuration stored?

The environment variables are configured in .cursor/mcp.json under the telegram server entry. Example: "env": { "TELEGRAM_TOKEN": "...", "CHAT_ID": "..." }.

What tools are available?

The server exposes one tool: send_telegram_message, which accepts a message string parameter. There are no other tools.

What are the limitations?

The server sends messages only to a single, pre‑configured chat ID. It does not support receiving messages or dynamic chat selection.