{"_id":"@parthj/telegram-notify-mcp","_rev":"2-8e8def0d3e0e5ebef79bf74be4b925d6","name":"@parthj/telegram-notify-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@parthj/telegram-notify-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","telegram","telegram-bot","ai-agents","notifications","claude","llm"],"author":{"name":"Parth Jadhav"},"license":"MIT","_id":"@parthj/telegram-notify-mcp@1.0.0","maintainers":[{"name":"parthj","email":"jadhavparth99@gmail.com"}],"homepage":"https://github.com/ParthJadhav/telegram-mcp#readme","bugs":{"url":"https://github.com/ParthJadhav/telegram-mcp/issues"},"bin":{"telegram-notify-mcp":"build/index.js"},"dist":{"shasum":"18806ccea7bb30c3903a4b5d6fb760b3eb926d35","tarball":"https://registry.npmjs.org/@parthj/telegram-notify-mcp/-/telegram-notify-mcp-1.0.0.tgz","fileCount":5,"integrity":"sha512-QnV7eXWr3xmJtDQAt9yXcPKVgsuCzcThJGU9d0nEBhRblVPtVPj4y1yYQZSlaG+v4/ojbeeKsOZ6D+rTjjquUA==","signatures":[{"sig":"MEYCIQDJpezOyq54FD8Ny7exh1g3ODsIwjJFeyiq8Gaki3LXMAIhAP6KaetwmAbr/FARQD53pL17Vlyw85D0PTkd7XPH4nyL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14310},"main":"./build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"787367778666fc21ca6e6d31bfc397a02ebc2f03","scripts":{"dev":"tsc --watch","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"parthj","email":"jadhavparth99@gmail.com"},"repository":{"url":"git+https://github.com/ParthJadhav/telegram-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"A dead-simple MCP server with one job: send AI agent progress back to you on Telegram — text, images, or files.","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notify-mcp_1.0.0_1771750538828_0.9431682837114894","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@parthj/telegram-notify-mcp","version":"1.0.1","mcpName":"io.github.ParthJadhav/telegram-notify-mcp","description":"A dead-simple MCP server with one job: send AI agent progress back to you on Telegram — text, images, or files.","type":"module","main":"./build/index.js","bin":{"telegram-notify-mcp":"build/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","dev":"tsc --watch","start":"node build/index.js"},"keywords":["mcp","model-context-protocol","telegram","telegram-bot","ai-agents","notifications","claude","llm"],"author":{"name":"Parth Jadhav"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ParthJadhav/telegram-notify-mcp.git"},"bugs":{"url":"https://github.com/ParthJadhav/telegram-notify-mcp/issues"},"homepage":"https://github.com/ParthJadhav/telegram-notify-mcp#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"gitHead":"c4a7a1b80aa29cf8648b26df8c1b33bd0cedb6bb","_id":"@parthj/telegram-notify-mcp@1.0.1","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-+Vzc/sFuAugPEA2YlObKwwho21lstgsWkmkAdumcjDdz4bAHJvyvFv5OR7PyZkfXDXGaAdZYySYJXsuxTFXagA==","shasum":"24487ae0ee2bd8f9896cd14eb503ea078fc84943","tarball":"https://registry.npmjs.org/@parthj/telegram-notify-mcp/-/telegram-notify-mcp-1.0.1.tgz","fileCount":5,"unpackedSize":14371,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAd/Q+4igWQSaoGgIHDrQWFFS2N7vspNV7XLogY0xUj4AiB8yA2V1QvFkuJ0XtONJBxzpSMEj9qlZo9zUYsBfpAnUw=="}]},"_npmUser":{"name":"parthj","email":"jadhavparth99@gmail.com"},"directories":{},"maintainers":[{"name":"parthj","email":"jadhavparth99@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-notify-mcp_1.0.1_1771752398887_0.8114777078956357"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-22T08:55:38.727Z","modified":"2026-02-22T09:26:39.153Z","1.0.0":"2026-02-22T08:55:38.966Z","1.0.1":"2026-02-22T09:26:39.019Z"},"bugs":{"url":"https://github.com/ParthJadhav/telegram-notify-mcp/issues"},"author":{"name":"Parth Jadhav"},"license":"MIT","homepage":"https://github.com/ParthJadhav/telegram-notify-mcp#readme","keywords":["mcp","model-context-protocol","telegram","telegram-bot","ai-agents","notifications","claude","llm"],"repository":{"type":"git","url":"git+https://github.com/ParthJadhav/telegram-notify-mcp.git"},"description":"A dead-simple MCP server with one job: send AI agent progress back to you on Telegram — text, images, or files.","maintainers":[{"name":"parthj","email":"jadhavparth99@gmail.com"}],"readme":"# Telegram Notify MCP\n\n[![npm version](https://img.shields.io/npm/v/@parthj/telegram-notify-mcp.svg)](https://www.npmjs.com/package/@parthj/telegram-notify-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA dead-simple [MCP](https://modelcontextprotocol.io) server with one job: **send AI agent progress back to you on Telegram.**\n\nThat's it. No chat management, no group administration, no inline queries. Just notifications — as text, images, or files.\n\nYou kick off an agent, walk away, and get a Telegram message when it's done (or while it's working). Nothing more, nothing less.\n\n## Quick Start\n\n### 1. Create a Telegram Bot\n\n1. Message [@BotFather](https://t.me/BotFather) on Telegram\n2. Send `/newbot` and follow the prompts\n3. Copy the bot token\n\n### 2. Start a chat with your bot\n\nFind your bot on Telegram and send `/start`. This is required so the bot can discover your chat ID.\n\n### 3. Add to your MCP client\n\n#### Claude Code\n\n```bash\nclaude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp\n```\n\n#### Claude Desktop / Cursor / Windsurf\n\nAdd to your MCP config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parthj/telegram-notify-mcp\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token\",\n        \"TELEGRAM_USERNAME\": \"your-telegram-username\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Environment Variable | Required | Description |\n|---|---|---|\n| `TELEGRAM_BOT_TOKEN` | Yes | Bot token from [@BotFather](https://t.me/BotFather) |\n| `TELEGRAM_USERNAME` | Yes | Your Telegram username (without the @) |\n\n## Tools\n\nThree tools. That's the entire surface area.\n\n### `send_message`\n\nSend a text update to the user.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `text` | string | Yes | The message text |\n| `parse_mode` | string | No | `HTML`, `Markdown`, or `MarkdownV2` |\n\n### `send_photo`\n\nSend an image — a screenshot, a chart, a generated visual.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `photo` | string | Yes | URL or absolute file path |\n| `caption` | string | No | Photo caption |\n| `parse_mode` | string | No | Caption formatting mode |\n\n### `send_document`\n\nSend a file — a report, a log, a build artifact.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `document` | string | Yes | URL or absolute file path |\n| `caption` | string | No | Document caption |\n| `parse_mode` | string | No | Caption formatting mode |\n\n## How It Works\n\n- On the first tool call, the server resolves your username to a chat ID via the Telegram Bot API's `getUpdates`\n- Sending `/start` to the bot is required — Telegram bots can only message users who have initiated a conversation\n- The chat ID is cached for the lifetime of the process\n\n## Development\n\n```bash\ngit clone https://github.com/ParthJadhav/telegram-notify-mcp.git\ncd telegram-notify-mcp\nnpm install\nnpm run build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}