{"_id":"telegram-notifier-mcp","_rev":"5-27ff015bf706f2ec8684fd371cf85a6a","name":"telegram-notifier-mcp","dist-tags":{"latest":"1.3.1"},"versions":{"1.0.0":{"name":"telegram-notifier-mcp","version":"1.0.0","_id":"telegram-notifier-mcp@1.0.0","maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"bin":{"telegram-notifier-mcp":"build/index.js"},"dist":{"shasum":"51b83807270e1f83772a61ead5e4088c20b899e7","tarball":"https://registry.npmjs.org/telegram-notifier-mcp/-/telegram-notifier-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-G98tUUiB/lRVoCQGzz3CLCEL9lWxQHiacqGZ16ofTF3PNP5aQrbD8ea37N9Ht0HKm0emWEk1Z/1kjlQM+t3KUg==","signatures":[{"sig":"MEQCIBQbtSIWBjW6Y+7lEPA8cdoE2mnfkhqIs0CRXe0P3jLFAiA2C9MvaFJAerqkjc+pfLiuKWIJZZHHJ9/ohriajZGURQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16215},"type":"module","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"elota_a","email":"adeshatole200@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for sending notifications via Telegram Bot API","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_1.0.0_1770990198150_0.19532192492845102","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"telegram-notifier-mcp","version":"1.1.0","keywords":["mcp","telegram","notifications","bot","model-context-protocol"],"license":"MIT","_id":"telegram-notifier-mcp@1.1.0","maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"homepage":"https://github.com/AdeshAtole/telegram-notifier-mcp#readme","bugs":{"url":"https://github.com/AdeshAtole/telegram-notifier-mcp/issues"},"bin":{"telegram-notifier-mcp":"build/index.js"},"dist":{"shasum":"6b83ca1723166f1ffadbaec5b3a4011dc583da59","tarball":"https://registry.npmjs.org/telegram-notifier-mcp/-/telegram-notifier-mcp-1.1.0.tgz","fileCount":4,"integrity":"sha512-d7tNQRInm2GWJqmB/AtJkloai7UppQ3OJljtNvCP9RkRBOMl9esIViJ2Blmc8ykB2WZzofC/r7m+vbM7d1AtJg==","signatures":[{"sig":"MEQCIGrkjI6/0WAvLKvTGt5k7Alifqg8CHFaFNyjleP+kV10AiBMHCLBzNVyAlSDzriLMcLmjSWKR6NC7fib1wwNmOypmg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20438},"type":"module","gitHead":"55a353555f6206f6122ea8802a8764d6abf7ff5e","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"elota_a","email":"adeshatole200@gmail.com"},"repository":{"url":"git+https://github.com/AdeshAtole/telegram-notifier-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for sending notifications via Telegram Bot API","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_1.1.0_1770996717657_0.631178306627209","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"telegram-notifier-mcp","version":"1.2.0","keywords":["mcp","telegram","notifications","bot","model-context-protocol"],"license":"MIT","_id":"telegram-notifier-mcp@1.2.0","maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"homepage":"https://github.com/AdeshAtole/telegram-notifier-mcp#readme","bugs":{"url":"https://github.com/AdeshAtole/telegram-notifier-mcp/issues"},"bin":{"telegram-notifier-mcp":"build/index.js"},"dist":{"shasum":"a703fd132b2aa2a0310228780b01e30d2c7a0672","tarball":"https://registry.npmjs.org/telegram-notifier-mcp/-/telegram-notifier-mcp-1.2.0.tgz","fileCount":4,"integrity":"sha512-X3cALzrGMa0WmpbA/XaBCPZiyJ9Ss0i+y39gHoCv73VI1P6nyPK0YbxpAtsKa+BTQ5ioYCNZqKVO+7vd8Hj5ug==","signatures":[{"sig":"MEYCIQCvh3MqFeWauxQG12LgeVsBIRTf/THrnEIna4oQcgXjNgIhALaYrRBrq+mOZIVidcSkgsRQ7DgV7m9IIqdpwuBLbHmB","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24093},"type":"module","gitHead":"80c47aa455ee10865142e5b74c557226b8dbfd65","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"elota_a","email":"adeshatole200@gmail.com"},"repository":{"url":"git+https://github.com/AdeshAtole/telegram-notifier-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for sending notifications via Telegram Bot API","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_1.2.0_1770997997767_0.37250061938116974","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"telegram-notifier-mcp","version":"1.3.0","keywords":["mcp","telegram","notifications","bot","model-context-protocol"],"license":"MIT","_id":"telegram-notifier-mcp@1.3.0","maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"homepage":"https://github.com/AdeshAtole/telegram-notifier-mcp#readme","bugs":{"url":"https://github.com/AdeshAtole/telegram-notifier-mcp/issues"},"bin":{"telegram-notifier-mcp":"build/index.js"},"dist":{"shasum":"a99398a2793bf14e68ecba6e2f0b768211a5e49a","tarball":"https://registry.npmjs.org/telegram-notifier-mcp/-/telegram-notifier-mcp-1.3.0.tgz","fileCount":4,"integrity":"sha512-DbH+HK0xTGa4GIm+pT+AsRVtaD6ohh3XPqXiJMWQkozOmiZLQ+/u3zkxfduKTYwodRfnB+MxiRWJbgGZxUaHlA==","signatures":[{"sig":"MEUCIQC8S8h30Mo4lOdQHtWSlYLtp1SFKdM6Wlh30FPNJ0W3dgIgZ3JZNm63yYN1Vp3AhbV9uCFJuMZceasTacqO3Mc3eds=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24649},"type":"module","gitHead":"2f304ec31b045318b6f68672470262c99be40858","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"elota_a","email":"adeshatole200@gmail.com"},"repository":{"url":"git+https://github.com/AdeshAtole/telegram-notifier-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for sending notifications via Telegram Bot API","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/telegram-notifier-mcp_1.3.0_1770999093757_0.8909671712290503","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"telegram-notifier-mcp","version":"1.3.1","description":"MCP server for sending notifications via Telegram Bot API","type":"module","bin":{"telegram-notifier-mcp":"build/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.2"},"repository":{"type":"git","url":"git+https://github.com/AdeshAtole/telegram-notifier-mcp.git"},"homepage":"https://github.com/AdeshAtole/telegram-notifier-mcp#readme","keywords":["mcp","telegram","notifications","bot","model-context-protocol"],"license":"MIT","devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_id":"telegram-notifier-mcp@1.3.1","gitHead":"9971dbbbec1c1feef8d469a01564042b9c1766f3","bugs":{"url":"https://github.com/AdeshAtole/telegram-notifier-mcp/issues"},"_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-ZW+SebnHyJ2m2lerJYXkwf/I5u8OaapeQ2WefI94WQeKbLuQfNUAZim4OhnkVg9jytrV97Hrt2ULq9wblvio2A==","shasum":"f08ddb4ac67ff3d828c94f00e4675714b110c48c","tarball":"https://registry.npmjs.org/telegram-notifier-mcp/-/telegram-notifier-mcp-1.3.1.tgz","fileCount":4,"unpackedSize":24093,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGjaA8x7jtparPBTbOCSbMmUOu32Qp9yHLvEmIUzcyRCAiEA+ctV/oWO6UWw71yLItLvHRxAxNeN1eqiMh3Zs/Qhx2c="}]},"_npmUser":{"name":"elota_a","email":"adeshatole200@gmail.com"},"directories":{},"maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-notifier-mcp_1.3.1_1770999363090_0.6742922986870032"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-13T13:43:18.149Z","modified":"2026-02-13T16:16:03.355Z","1.0.0":"2026-02-13T13:43:18.298Z","1.1.0":"2026-02-13T15:31:57.870Z","1.2.0":"2026-02-13T15:53:17.918Z","1.3.0":"2026-02-13T16:11:33.917Z","1.3.1":"2026-02-13T16:16:03.223Z"},"bugs":{"url":"https://github.com/AdeshAtole/telegram-notifier-mcp/issues"},"license":"MIT","homepage":"https://github.com/AdeshAtole/telegram-notifier-mcp#readme","keywords":["mcp","telegram","notifications","bot","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/AdeshAtole/telegram-notifier-mcp.git"},"description":"MCP server for sending notifications via Telegram Bot API","maintainers":[{"name":"elota_a","email":"adeshatole200@gmail.com"}],"readme":"# Telegram Notifier MCP Server\n\nAn [MCP](https://modelcontextprotocol.io/) server that lets an LLM send messages and files to a user via a Telegram bot, and read incoming messages. No external HTTP or Telegram libraries — just the native `fetch` API and the official MCP SDK.\n\n## Quick Start\n\nNo cloning or building required — just add the config to your MCP client.\n\n### 1. Create a Telegram Bot\n\n1. Open Telegram and message [@BotFather](https://t.me/BotFather)\n2. Send `/newbot` and follow the prompts to name your bot\n3. Copy the **bot token** you receive (e.g., `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`)\n\n### 2. Find Your Chat ID\n\n1. Send any message to your new bot on Telegram\n2. Open the following URL in your browser, replacing `YOUR_BOT_TOKEN` with your actual token:\n   ```\n   https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates\n   ```\n3. In the JSON response, find `\"chat\":{\"id\": 123456789}` — that number is your chat ID\n\n> **Tip:** For group chats, add the bot to the group, send a message, and check the same URL. Group chat IDs are negative numbers (e.g., `-1001234567890`).\n\n### 3. Add to Your MCP Client\n\n#### Claude Desktop\n\nAdd this to your Claude Desktop config file:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-notifier\": {\n      \"command\": \"npx\",\n      \"args\": [\"telegram-notifier-mcp\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token-here\",\n        \"TELEGRAM_CHAT_ID\": \"your-chat-id-here\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Code\n\nAdd to your project's `.mcp.json` or `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"telegram-notifier\": {\n      \"command\": \"npx\",\n      \"args\": [\"telegram-notifier-mcp\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token-here\",\n        \"TELEGRAM_CHAT_ID\": \"your-chat-id-here\"\n      }\n    }\n  }\n}\n```\n\nThat's it — your LLM can now send you Telegram notifications.\n\n## Configuration\n\nThe server uses two environment variables:\n\n| Variable | Required | Description |\n|---|---|---|\n| `TELEGRAM_BOT_TOKEN` | Yes | Bot token from @BotFather |\n| `TELEGRAM_CHAT_ID` | No | Default chat ID. Can be overridden per-tool call via the `chatId` parameter. |\n\nThe server will exit with an error if `TELEGRAM_BOT_TOKEN` is not set. If `TELEGRAM_CHAT_ID` is not set, you must pass `chatId` to every tool call.\n\n## Tools\n\n### `send_message`\n\nSend a text message to a Telegram chat.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `text` | string | Yes | The message text to send |\n| `chatId` | string | No | Target chat ID (overrides `TELEGRAM_CHAT_ID`) |\n| `parseMode` | string | No | `Markdown`, `MarkdownV2`, or `HTML` |\n| `disableNotification` | boolean | No | Send silently without notification sound |\n\n### `send_document`\n\nSend a file/document to a Telegram chat.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `filePath` | string | Yes | Absolute path to the file |\n| `chatId` | string | No | Target chat ID (overrides `TELEGRAM_CHAT_ID`) |\n| `caption` | string | No | Caption for the document |\n| `parseMode` | string | No | `Markdown`, `MarkdownV2`, or `HTML` |\n| `disableNotification` | boolean | No | Send silently without notification sound |\n\n### `send_photo`\n\nSend a photo/image to a Telegram chat.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `filePath` | string | Yes | Absolute path to the image file |\n| `chatId` | string | No | Target chat ID (overrides `TELEGRAM_CHAT_ID`) |\n| `caption` | string | No | Caption for the photo |\n| `parseMode` | string | No | `Markdown`, `MarkdownV2`, or `HTML` |\n| `disableNotification` | boolean | No | Send silently without notification sound |\n\n### `send_video`\n\nSend a video to a Telegram chat.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `filePath` | string | Yes | Absolute path to the video file |\n| `chatId` | string | No | Target chat ID (overrides `TELEGRAM_CHAT_ID`) |\n| `caption` | string | No | Caption for the video |\n| `parseMode` | string | No | `Markdown`, `MarkdownV2`, or `HTML` |\n| `disableNotification` | boolean | No | Send silently without notification sound |\n\n### `send_audio`\n\nSend an audio file to a Telegram chat.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `filePath` | string | Yes | Absolute path to the audio file |\n| `chatId` | string | No | Target chat ID (overrides `TELEGRAM_CHAT_ID`) |\n| `caption` | string | No | Caption for the audio |\n| `parseMode` | string | No | `Markdown`, `MarkdownV2`, or `HTML` |\n| `disableNotification` | boolean | No | Send silently without notification sound |\n\n### `get_updates`\n\nCheck for new messages sent to the bot. Only returns messages received since the last check.\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `limit` | number | No | Max messages to retrieve (1-100, default 10) |\n| `timeout` | number | No | Long-polling timeout in seconds (0-30, default 0). Set >0 to wait for new messages. |\n\n#### File Downloads\n\nWhen a message contains media (photo, document, video, audio, voice message, or sticker), the server automatically downloads the file to `~/.telegram-notifier-mcp/downloads/` and includes the local path in the output. This lets the LLM read or process the file directly.\n\n- Files are saved as `<timestamp>-<original_filename>` to avoid collisions\n- Photos are downloaded at the highest available resolution\n- Telegram Bot API limits downloads to **20 MB**\n- If a download fails, the output falls back to just labeling the media type\n\n## Testing with the MCP Inspector\n\nYou can test the server interactively using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):\n\n```bash\nTELEGRAM_BOT_TOKEN=\"your-token\" TELEGRAM_CHAT_ID=\"your-chat-id\" \\\n  npx @modelcontextprotocol/inspector npx telegram-notifier-mcp\n```\n\nThis opens a browser UI where you can invoke each tool and see the results.\n\n## Error Handling\n\nThe server handles errors gracefully and returns descriptive messages:\n\n| Scenario | Behavior |\n|---|---|\n| Missing `TELEGRAM_BOT_TOKEN` | Server exits at startup with instructions |\n| Missing chat ID (no env var, no parameter) | Returns `isError: true` with message |\n| File not found | Returns `isError: true` with the file path |\n| File exceeds 50 MB | Returns `isError: true` with file size |\n| Telegram API error | Returns `isError: true` with Telegram's error description |\n\nAll server logs go to **stderr** so they never interfere with the stdio MCP transport on stdout.\n\n## File Size Limits\n\nTelegram enforces a **50 MB** limit for file uploads via the Bot API. The server validates file size before uploading and returns an error if the limit is exceeded.\n\n## Development\n\n```bash\ngit clone https://github.com/AdeshAtole/telegram-notifier-mcp\ncd telegram-notifier-mcp\nnpm install\nnpm run build\n\n# Watch mode — rebuilds on file changes\nnpm run dev\n```\n\n## Publishing\n\nReleases are published to npm automatically via GitHub Actions when you create a GitHub release.\n\n**Setup:**\n1. Add your npm token as a repository secret named `NPM_TOKEN` in GitHub Settings > Secrets and variables > Actions\n2. Bump the version in `package.json`\n3. Create a new GitHub release — the workflow will build and publish to npm\n\n## License\n\nMIT\n","readmeFilename":"README.md"}