{"_id":"telegram-mcp-bot","_rev":"5-711f3ecf1ff357dabf73b7a29b6342fe","name":"telegram-mcp-bot","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"telegram-mcp-bot","version":"1.0.0","keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"author":{"name":"Hatip Aksunger"},"license":"MIT","_id":"telegram-mcp-bot@1.0.0","maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"homepage":"https://github.com/hatip5656/telegram-mcp#readme","bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"bin":{"telegram-mcp":"dist/index.js"},"dist":{"shasum":"f30cedc58daea632423e6c9f77692a1ace080caf","tarball":"https://registry.npmjs.org/telegram-mcp-bot/-/telegram-mcp-bot-1.0.0.tgz","fileCount":31,"integrity":"sha512-WOyfWqtewtSZpAR6jKVU/+IdyqrfF3tJsTqgs9fDJg6FxbiCtkxWF3r/W2cp183e/gAQ7EK+pPJpS1Z2D2WIaw==","signatures":[{"sig":"MEQCIGgrwN6RVj3XAUvigkupAtnyVM/4iFW0y4MLMnuMNcw0AiBXX9rpL53fmZwRTYPNHTvm5aVnx5IOicGT9TzCdh8S4g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/telegram-mcp-bot@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":59910},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"71406d6f649b955059d3a9ef425d73a5061c23f5","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"},"repository":{"url":"git+https://github.com/hatip5656/telegram-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Telegram MCP server for two-way bot communication with session management","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.3.6","grammy":"^1.41.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp-bot_1.0.0_1775477405516_0.1424458716140249","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"telegram-mcp-bot","version":"1.0.1","keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"author":{"name":"Hatip Aksunger"},"license":"MIT","_id":"telegram-mcp-bot@1.0.1","maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"homepage":"https://github.com/hatip5656/telegram-mcp#readme","bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"bin":{"telegram-mcp-bot":"dist/index.js"},"dist":{"shasum":"50c1b566edac2fb50808e9d536e1e0d8f156545a","tarball":"https://registry.npmjs.org/telegram-mcp-bot/-/telegram-mcp-bot-1.0.1.tgz","fileCount":31,"integrity":"sha512-qXps8682bDpPNIn/w1JfKErLOUe67vx4Bdn4qH5r1wP+cGVnGygOdTn9BETGRmPeI5EmN2+Jb0S7ZgZXBJtJkQ==","signatures":[{"sig":"MEUCIQCFVbpL+3Pjk3pMQe9sp+OXHogiTvEXC24ua+1850ljmgIgafsrPZVF+1kGbezQQYrvM6Pvb5czrjsKeacEOTv+qIw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/telegram-mcp-bot@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":60166},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"1248589ee5ac8dbf56349dd3803da519b3c59e6c","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"},"repository":{"url":"git+https://github.com/hatip5656/telegram-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Telegram MCP server for two-way bot communication with session management","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.3.6","grammy":"^1.41.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp-bot_1.0.1_1775478816488_0.6170017046050074","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"telegram-mcp-bot","version":"1.0.4","keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"author":{"name":"Hatip Aksunger"},"license":"MIT","_id":"telegram-mcp-bot@1.0.4","maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"homepage":"https://github.com/hatip5656/telegram-mcp#readme","bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"bin":{"telegram-mcp-bot":"dist/index.js"},"dist":{"shasum":"01e9ab2539c37f3c9f58b57b1b3b207368c45707","tarball":"https://registry.npmjs.org/telegram-mcp-bot/-/telegram-mcp-bot-1.0.4.tgz","fileCount":31,"integrity":"sha512-IxkMqd5bNcKb4QpWZmYGuokZd2yYIh+Qjp5VXdLuRYeZx8qukp+EGjgAmmkiRl0fjUrkA/bWs6OXvOOB3MVyAQ==","signatures":[{"sig":"MEUCIEu+9t5aTC+adohD1O/IHZCXa8t3+IF33To0FUBINAKuAiEA3LbVmoNe2LIB2ixR3H0xt0zAaJtoo1gfHIl7hkVqCj8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/telegram-mcp-bot@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":61232},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a63d16748c17e0088ebb63b7b3338e1c65b01a06","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"},"repository":{"url":"git+https://github.com/hatip5656/telegram-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Telegram MCP server for two-way bot communication with session management","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.3.6","grammy":"^1.41.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp-bot_1.0.4_1776081385877_0.32656134372516554","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"telegram-mcp-bot","version":"1.0.5","keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"author":{"name":"Hatip Aksunger"},"license":"MIT","_id":"telegram-mcp-bot@1.0.5","maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"homepage":"https://github.com/hatip5656/telegram-mcp#readme","bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"bin":{"telegram-mcp-bot":"dist/index.js"},"dist":{"shasum":"ecfe3a8eb6d5c317a0498963b141c08644ff4487","tarball":"https://registry.npmjs.org/telegram-mcp-bot/-/telegram-mcp-bot-1.0.5.tgz","fileCount":31,"integrity":"sha512-sd/Ti+gn2J/O/sd7daJdsuIIg58DsffkBFVc8YvqJ50b1dlJJmcQKdEBsCYY5eP++zHM3+6D9SsYoTuEHoDWOQ==","signatures":[{"sig":"MEQCIHnUiJPhUAitc6ru+Y5dYI9iSAYEh5NnfGaJbcqQu+H7AiAxRUA4rjvHuuce3rr+1itjMngslyxmLziMH+sL9oyb7Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/telegram-mcp-bot@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":54526},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b94999acbd6f1afd5d392cdca1dc20d0f9fad8b5","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"},"repository":{"url":"git+https://github.com/hatip5656/telegram-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Telegram MCP server for two-way bot communication with session management","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.3.6","grammy":"^1.41.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.2"},"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp-bot_1.0.5_1778960434505_0.861593660586895","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"telegram-mcp-bot","version":"1.1.0","description":"Telegram MCP server for two-way bot communication with session management","type":"module","main":"dist/index.js","bin":{"telegram-mcp-bot":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"author":{"name":"Hatip Aksunger"},"repository":{"type":"git","url":"git+https://github.com/hatip5656/telegram-mcp.git"},"homepage":"https://github.com/hatip5656/telegram-mcp#readme","bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","grammy":"^1.41.1","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.5.2","tsx":"^4.21.0","typescript":"^6.0.2"},"_id":"telegram-mcp-bot@1.1.0","gitHead":"31c745d880732707cff050675884b7ee245d6ac3","types":"./dist/index.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-9c2ADQsc29JpyY1knd6tae678UNoNJkt6s5NvZJmuTXZa9wclCimoa0/XLf6ibbPx8n0TOFlqOcdMIZVr5QTig==","shasum":"a0186f51f3a854d4a4fe622569c48e19d48e1be6","tarball":"https://registry.npmjs.org/telegram-mcp-bot/-/telegram-mcp-bot-1.1.0.tgz","fileCount":31,"unpackedSize":68567,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/telegram-mcp-bot@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDe9AF10W5gnS5IW5S/hZ4lLD+yVwaFdOeILtqtiSRpOAIhALyGel4pBjt5iFsExh9x+ksgfbLgzRQgfjNyGvmQke+W"}]},"_npmUser":{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"},"directories":{},"maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-mcp-bot_1.1.0_1778965764319_0.9103551537081853"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-06T12:10:05.436Z","modified":"2026-05-16T21:09:24.814Z","1.0.0":"2026-04-06T12:10:05.678Z","1.0.1":"2026-04-06T12:33:36.650Z","1.0.4":"2026-04-13T11:56:26.035Z","1.0.5":"2026-05-16T19:40:34.639Z","1.1.0":"2026-05-16T21:09:24.480Z"},"bugs":{"url":"https://github.com/hatip5656/telegram-mcp/issues"},"author":{"name":"Hatip Aksunger"},"license":"MIT","homepage":"https://github.com/hatip5656/telegram-mcp#readme","keywords":["mcp","telegram","bot","claude","claude-code","model-context-protocol","ai","session-management"],"repository":{"type":"git","url":"git+https://github.com/hatip5656/telegram-mcp.git"},"description":"Telegram MCP server for two-way bot communication with session management","maintainers":[{"name":"hatipaksunger","email":"hatip.aksunger@gmail.com"}],"readme":"# telegram-mcp-bot\n\n[![npm version](https://img.shields.io/npm/v/telegram-mcp-bot)](https://www.npmjs.com/package/telegram-mcp-bot)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server that connects Claude Code to Telegram via a bot.\n\n---\n\n## Setup\n\n1. Create a bot via [@BotFather](https://t.me/BotFather) and copy the token\n2. Add the MCP server:\n\n```bash\nclaude mcp add telegram -s user -e TELEGRAM_BOT_TOKEN=your-token -- npx -y telegram-mcp-bot@latest\n```\n\n3. Message the bot once from Telegram — it remembers you from then on\n\nThat's it. Claude can now send and receive messages through the bot.\n\n---\n\n## How It Works\n\nThe bot persists known chats to `~/.telegram-mcp/chats.json`. After a user messages the bot once, their chat is remembered across restarts. Send tools default to the most recent chat, so `chat_id` is usually not needed.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `send_message` | Send a text message |\n| `send_photo` | Send a photo (URL, file ID, or local path) |\n| `get_updates` | Read incoming messages (cursor-based, session-filtered) |\n| `list_chats` | List all known chats |\n| `set_session` | Set a name/emoji prefix and register a Telegram command for this session |\n\nAll send tools default `chat_id` to the most recent known chat.\n\n## Multi-Session Support\n\nMultiple Claude Code sessions can share the same bot. Each session registers itself with a name and emoji:\n\n```\nclaude mcp add telegram -s user \\\n  -e TELEGRAM_BOT_TOKEN=your-token \\\n  -e SESSION_NAME=debug-api \\\n  -e SESSION_EMOJI=🟢 \\\n  -- npx -y telegram-mcp-bot@latest\n```\n\nThe bot automatically registers Telegram commands per session. In Telegram, tap `/debug_api` to direct your messages to that session. Use `/setup` to see all active sessions and your current target.\n\nMessages are routed: each session only receives messages targeted at it (or untargeted messages if no session is selected).\n\n## Telegram Commands\n\n| Command | Description |\n|---------|-------------|\n| `/setup` | Show chat ID, active sessions, and current target |\n| `/<session_name>` | Switch message target to that session |\n\nCommands are registered dynamically when sessions connect/disconnect.\n\n## Optional Environment Variables\n\n| Variable | Description |\n|---|---|\n| `SESSION_NAME` | Session name — registers a Telegram command and prefixes outgoing messages |\n| `SESSION_EMOJI` | Emoji prefix (e.g. `🔵`) |\n| `DATA_DIR` | Override data directory (default: `~/.telegram-mcp`) |\n\n---\n\n## MCP Resources\n\n| Resource URI | Description |\n|---|---|\n| `telegram://chat/{chatId}/messages` | Messages from a specific chat |\n| `telegram://updates/recent` | Recent messages across all chats |\n\n---\n\n## Development\n\n```bash\ngit clone git@github.com:hatip5656/telegram-mcp.git\ncd telegram-mcp\nnpm install\nnpm run build\nTELEGRAM_BOT_TOKEN=your-token npm run dev\n```\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}