Telegram MCP Server logo

Telegram MCP Server

by MobileVibe

The Telegram MCP Server enables LLMs to send notifications via Telegram and receive user responses. It integrates with Cline and other MCP-compatible LLM applications.

View on GitHub

Last updated: N/A

What is Telegram MCP Server?

The Telegram MCP Server is a Model Context Protocol (MCP) server that allows Large Language Models (LLMs) to interact with users through Telegram. It facilitates sending notifications and retrieving user responses, enabling conversational workflows.

How to use Telegram MCP Server?

First, install the server using npm or GitHub. Configure it with your Telegram bot token and chat ID, obtained from BotFather. Then, run the server standalone or integrate it with Cline or Claude Desktop by adding the server configuration to their respective settings files. Use the available tools like send_notification and check_notification_response to interact with users.

Key features of Telegram MCP Server

  • Send text notifications to a Telegram chat with customizable urgency levels

  • Wait for and retrieve user responses from Telegram

  • Integrates with Cline

  • Integrates with Claude Desktop

  • Provides tools for sending notifications and checking responses

Use cases of Telegram MCP Server

  • LLMs can send alerts and reminders to users via Telegram

  • LLMs can gather user feedback and input through Telegram

  • LLMs can conduct surveys and polls via Telegram

  • LLMs can provide real-time updates and notifications to users

FAQ from Telegram MCP Server

How do I get a Telegram bot token?

Start a chat with @BotFather on Telegram, send the command /newbot, and follow the instructions to create a new bot. BotFather will provide you with a token.

How do I find my Telegram chat ID?

Start a chat with your new bot, send a message, and visit https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates. Look for the chat object and note the id field.

What are the required environment variables?

The server requires TELEGRAM_BOT_TOKEN (your Telegram bot token) and TELEGRAM_CHAT_ID (your Telegram chat ID).

How do I send a notification?

Use the send_notification tool with the message, project, and optional urgency parameters.

How do I check for a user response?

Use the check_notification_response tool with the message_id and optional timeout_seconds parameters.