{"id":"8ec07e2d-4ebd-4c58-ae5a-ff68390c7b7b","slug":"mobilevibe-telegram-mcp","kind":"mcp","name":"telegram-mcp","summary":"MCP server to send notifications to Telegram","owner":"MobileVibe","repoUrl":"https://github.com/MobileVibe/telegram-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":4,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-03-12T12:44:30.000Z","addedAt":"2026-10-14T05:37:12.163Z","logoUrl":"https://avatars.githubusercontent.com/u/202861600?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["communication","cloud-infra"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T00:30:26.842Z","sample":false,"url":"https://conduits.dev/tools/mobilevibe-telegram-mcp","language":"JavaScript","transports":["stdio"],"install":{"npm":"telegram-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Telegram MCP Server\n\nA Model Context Protocol (MCP) server that enables LLMs to send notifications via Telegram and receive user responses.\n\n## Features\n\n- Send text notifications to a Telegram chat with customizable urgency levels\n- Wait for and retrieve user responses\n- Integrates with Cline and other MCP-compatible LLM applications\n\n## Prerequisites\n\n- Node.js 16 or higher\n- A Telegram bot token (obtained from [@BotFather](https://t.me/botfather))\n- Your Telegram chat ID\n\n## Installation\n\n### From npm (recommended)\n\n```bash\nnpm install -g telegram-mcp\n```\n\n### From GitHub\n\n```bash\ngit clone https://github.com/CHarrisTech/telegram-mcp.git\ncd telegram-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\nThe server requires two environment variables:\n\n- `TELEGRAM_BOT_TOKEN`: Your Telegram bot token\n- `TELEGRAM_CHAT_ID`: Your Telegram chat ID\n\n### Getting a Telegram Bot Token\n\n1. Start a chat with [@BotFather](https://t.me/botfather) on Telegram\n2. Send the command `/newbot`\n3. Follow the instructions to create a new bot\n4. BotFather will provide you with a token for your new bot\n\n### Finding Your Chat ID\n\n1. Start a chat with your new bot\n2. Send a message to the bot\n3. Visit `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates`\n4. Look for the `chat` object in the response and note the `id` field\n\n## Usage\n\n### Running Standalone\n\n```bash\n# Set environment variables\nexport TELEGRAM_BOT_TOKEN=\"your_bot_token\"\nexport TELEGRAM_CHAT_ID=\"your_chat_id\"\n\n# Run the server\ntelegram-mcp\n```\n\n### Integrating with Cline\n\nAdd the following to your Cline MCP settings file:\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/telegram-mcp/build/index.js\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your_bot_token\",\n        \"TELEGRAM_CHAT_ID\": \"your_chat_id\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n### Integrating with Claude Desktop\n\nAdd the following to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/telegram-mcp/build/index.js\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your_bot_token\",\n        \"TELEGRAM_CHAT_ID\": \"your_chat_id\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n## Available Tools\n\n### send_notification\n\nSends a notification message to the configured Telegram chat.\n\nParameters:\n- `message` (required): The message to send to the user\n- `project` (required): The name of the project the LLM is working on\n- `urgency` (optional): The urgency level (\"low\", \"medium\", or \"high\")\n\n### check_notification_response\n\nChecks if the user has responded to a previously sent notification.\n\nParameters:\n- `message_id` (required): The ID of the message to check for responses\n- `timeout_seconds` (optional): How long to wait for a response before giving up (default: 30)\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/CHarrisTech/telegram-mcp.git\ncd telegram-mcp\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Watch for changes during development\nnpm run watch\n\n# Test with the MCP Inspector\nnpm run inspector\n```\n\n### Testing Locally\n\nThe repository includes scripts to help you test the server locally:\n\n#### Windows\n```cmd\n# Set environment variables\nset TELEGRAM_BOT_TOKEN=your_bot_token\nset TELEGRAM_CHAT_ID=your_chat_id\n\n# Run the test script\ntest-server.bat\n```\n\n#### macOS/Linux\n```bash\n# Set environment variables\nexport TELEGRAM_BOT_TOKEN=your_bot_token\nexport TELEGRAM_CHAT_ID=your_chat_id\n\n# Make the script executable (first time only)\nchmod +x test-server.sh\n\n# Run the test script\n./test-server.sh\n```\n\n## Examples\n\nThe `examples` directory contains sample code demonstrating how to use the Telegram MCP server:\n\n- `programmatic-usage.js`: Shows how to use the server programmatically in your own Node.js applications\n\nTo run an example:\n\n```bash\n# Set required environment variables\nexport TELEGRAM_BOT_TOKEN=\"your_bot_token\"\nexport TELEGRAM_CHAT_ID=\"your_chat_id\"\n\n# Run the example\nnode examples/programmatic-usage.js\n```\n\n## License\n\nMIT\n"}