{"_id":"slack-notify-mcp","_rev":"4-f40279025a443945782cee4a158bd6d1","name":"slack-notify-mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.0":{"name":"slack-notify-mcp","version":"0.2.0","keywords":["mcp","slack","webhook","modelcontextprotocol","bot","chat","notification","integration"],"author":{"name":"Your Name","email":"your.email@example.com"},"license":"MIT","_id":"slack-notify-mcp@0.2.0","maintainers":[{"name":"sreinagel","email":"silas.reinagel@gmail.com"}],"homepage":"https://github.com/SilasReinagel/slack-notify-mcp#readme","bugs":{"url":"https://github.com/SilasReinagel/slack-notify-mcp/issues"},"bin":{"slack-notify-mcp":"dist/src/index.js"},"dist":{"shasum":"a268b30b433aed0a679eb10af6ef5106be8db3be","tarball":"https://registry.npmjs.org/slack-notify-mcp/-/slack-notify-mcp-0.2.0.tgz","fileCount":11,"integrity":"sha512-ifZr4JcdZcRJNpYt3UoKxwk06iLtVVnR5mdLBnrkqcKOh53euxHUA11zPYntziw5jaQje6HKkqcNNY5wsIe6hg==","signatures":[{"sig":"MEUCIDbZ6PKW4c7HbcMvTDaM1PsFnRk4dZI8Ib5ii+10XwkaAiEAy1nJZzsjmXyAszEEDpnZ+Bp3BhnUMgRXHmNgJ9jqEZU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33786},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e0e59e3bcbde49edabdb2cfefd36205a86586a46","scripts":{"dev":"bun --watch run src/index.ts","lint":"echo \"No linter configured\"","test":"echo \"Error: no test specified\" && exit 1","build":"npm run clean && npm run compile","clean":"rm -rf dist","start":"node dist/index.js","compile":"tsc","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"sreinagel","actor":{"name":"sreinagel","type":"user","email":"silas.reinagel@gmail.com"},"email":"silas.reinagel@gmail.com"},"repository":{"url":"git+https://github.com/SilasReinagel/slack-notify-mcp.git","type":"git"},"_npmVersion":"10.2.4","description":"MCP server for posting messages to Slack webhooks and bot API","directories":{},"_nodeVersion":"20.11.1","dependencies":{"zod":"^3.25.64","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/slack-notify-mcp_0.2.0_1750277287077_0.2814805374408076","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"slack-notify-mcp","version":"0.3.0","description":"MCP server for posting messages to Slack webhooks and bot API","main":"dist/src/index.js","types":"dist/src/index.d.ts","type":"module","bin":{"slack-notify-mcp":"dist/src/index.js"},"scripts":{"start":"node dist/index.js","dev":"bun --watch run src/index.ts","build":"npm run clean && npm run compile","clean":"rm -rf dist","compile":"tsc","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1","lint":"echo \"No linter configured\"","typecheck":"tsc --noEmit"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/SilasReinagel/slack-notify-mcp.git"},"bugs":{"url":"https://github.com/SilasReinagel/slack-notify-mcp/issues"},"homepage":"https://github.com/SilasReinagel/slack-notify-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","axios":"^1.7.9","zod":"^3.25.64"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.0.0"},"keywords":["mcp","slack","webhook","modelcontextprotocol","bot","chat","notification","integration"],"author":{"name":"Your Name","email":"your.email@example.com"},"license":"MIT","_id":"slack-notify-mcp@0.3.0","gitHead":"c2eb70e2924c8db85a6d11d3f76120bca7fd682b","_nodeVersion":"20.11.1","_npmVersion":"10.2.4","dist":{"integrity":"sha512-BMXmGuY+CEQrXp6s8NYV+NT/zo79r6zi5xYpDLSgFjmhF41QdOkfqogfefpmEm03a8iKuC863uUlLvwLRsCA2A==","shasum":"0e3479855c38616d72febdb031897c955afd54c9","tarball":"https://registry.npmjs.org/slack-notify-mcp/-/slack-notify-mcp-0.3.0.tgz","fileCount":11,"unpackedSize":34048,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDwrryZPyWcttCjaBuB5kQW1wHR99iuSTajvA9dpKasrAIhANx3/sVbv+s9c60nDdDaCHpaU3Q+nwzpnghsfAbjM2oN"}]},"_npmUser":{"name":"sreinagel","email":"silas.reinagel@gmail.com"},"directories":{},"maintainers":[{"name":"sreinagel","email":"silas.reinagel@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/slack-notify-mcp_0.3.0_1753108740514_0.6044089755617841"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-18T20:01:30.876Z","modified":"2025-07-21T14:39:00.885Z","1.0.0":"2025-06-18T20:01:31.075Z","0.2.0":"2025-06-18T20:08:07.257Z","0.3.0":"2025-07-21T14:39:00.691Z"},"bugs":{"url":"https://github.com/SilasReinagel/slack-notify-mcp/issues"},"author":{"name":"Your Name","email":"your.email@example.com"},"license":"MIT","homepage":"https://github.com/SilasReinagel/slack-notify-mcp#readme","keywords":["mcp","slack","webhook","modelcontextprotocol","bot","chat","notification","integration"],"repository":{"type":"git","url":"git+https://github.com/SilasReinagel/slack-notify-mcp.git"},"description":"MCP server for posting messages to Slack webhooks and bot API","maintainers":[{"name":"sreinagel","email":"silas.reinagel@gmail.com"}],"readme":"# Slack Webhook MCP Server\n\nA Model Context Protocol (MCP) server for posting messages to Slack via webhooks or bot tokens.\n\n## Features\n\n- **Two modes of operation**: Webhooks or Bot API\n- Post messages to Slack channels\n- Support for channel overrides  \n- Configurable bot username and emoji\n- Slack-specific mention support (`<!channel>`, `<!here>`, `<@USERID>`)\n- Comprehensive error handling and validation\n\n## Installation\n\n```bash\nbun install\n```\n\n## Setup\n\n### Option 1: Webhook Mode (Simple)\n\n1. **Create a Slack App and Webhook**:\n   - Go to [Slack API Apps](https://api.slack.com/apps)\n   - Create a new app or select an existing one\n   - Navigate to \"Incoming Webhooks\" \n   - Enable incoming webhooks\n   - Add a new webhook to your workspace\n   - Copy the webhook URL (format: `https://hooks.slack.com/services/T.../B.../...`)\n\n2. **Configure MCP Client**:\n```json\n{\n  \"mcpServers\": {\n    \"slack-webhook\": {\n      \"command\": \"bun\",\n      \"args\": [\n        \"run\", \n        \"src/index.ts\",\n        \"--webhook-url\",\n        \"https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK\",\n        \"--channel\",\n        \"#general\"\n      ],\n      \"cwd\": \"/path/to/slack-webhook-mcp-server\"\n    }\n  }\n}\n```\n\n### Option 2: Bot Token Mode (Advanced)\n\n1. **Create a Slack App with Bot Token**:\n   - Go to [Slack API Apps](https://api.slack.com/apps)\n   - Create a new app or select an existing one\n   - Go to \"OAuth & Permissions\"\n   - Add bot token scopes: `chat:write`, `chat:write.public`\n   - Install app to workspace\n   - Copy the \"Bot User OAuth Token\" (starts with `xoxb-`)\n\n2. **Get Channel IDs**:\n   - Right-click on channel in Slack → \"View channel details\" → Copy channel ID\n   - Or use Slack API to list channels\n\n3. **Configure MCP Client**:\n```json\n{\n  \"mcpServers\": {\n    \"slack-bot\": {\n      \"command\": \"bun\",\n      \"args\": [\n        \"run\", \n        \"src/index.ts\",\n        \"--bot-token\",\n        \"xoxb-YOUR-BOT-TOKEN\",\n        \"--channel\",\n                  \"CXXXXXXXXXX\",\n        \"--username\",\n        \"MCP Bot\"\n      ],\n      \"cwd\": \"/path/to/slack-webhook-mcp-server\"\n    }\n  }\n}\n```\n\n## Usage\n\n### Command Line Arguments\n\n**Webhook Mode:**\n- `--webhook-url <url>` - Slack webhook URL (required)\n- `--channel <channel>` - Default channel name (optional, e.g., \"#general\")\n\n**Bot Mode:**\n- `--bot-token <token>` - Slack bot token (required, starts with `xoxb-`)\n- `--channel <channel>` - Default channel ID (required, e.g., \"CXXXXXXXXXX\")\n\n**Common Options:**\n- `--username <username>` - Default bot username (optional)\n- `--icon-emoji <emoji>` - Default bot emoji (optional, e.g., \":robot_face:\")\n- `--help` - Show help message\n\n### Examples\n\n**Webhook Mode:**\n```bash\nbun run src/index.ts \\\n  --webhook-url \"https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX\" \\\n  --channel \"#general\" \\\n  --username \"Assistant\"\n```\n\n**Bot Mode:**\n```bash\nbun run src/index.ts \\\n  --bot-token \"xoxb-YOUR-BOT-TOKEN\" \\\n  --channel \"CXXXXXXXXXX\" \\\n  --username \"Assistant\"\n```\n\n### Available Tools\n\n#### `post_slack_message`\n\nPost a message to your configured Slack integration.\n\n**Parameters:**\n- `message` (required): The message content to send (max 4000 characters)\n- `channel` (optional): Channel to post to (overrides default)\n  - Webhook mode: Channel name (e.g., \"#random\") \n  - Bot mode: Channel ID (e.g., \"CXXXXXXXXXX\")\n- `username` (optional): Override the default username for this message\n- `icon_emoji` (optional): Override the default emoji for this message\n\n**Example usage in MCP client:**\n```\nPlease post \"Hello from MCP!\" to the general channel\n```\n\n## Mode Comparison\n\n| Feature | Webhook Mode | Bot Mode |\n|---------|-------------|----------|\n| **Setup** | Simple | Requires OAuth setup |\n| **Channel Reference** | Names (#general) | IDs (CXXXXXXXXXX) |\n| **Permissions** | Limited to webhook channel | Configurable scopes |\n| **Rate Limits** | Higher | Standard API limits |\n| **Features** | Basic messaging | Full API access |\n| **Authentication** | URL-based | Token-based |\n\n## Slack-Specific Features\n\n### Mentions\n- User mention: `<@U1234567890>`\n- Channel notification: `<!channel>`\n- Here notification: `<!here>`\n\n### Channel References\n- **Webhook mode**: Use `#channel-name` format\n- **Bot mode**: Use channel IDs like `CXXXXXXXXXX`\n\n## Development\n\n### Scripts\n\n- `bun run start` - Start the server\n- `bun run dev` - Start with file watching  \n- `bun run build` - Build for production\n\n### Project Structure\n\n```\nslack-webhook-mcp-server/\n├── package.json          # Dependencies and scripts\n├── src/\n│   └── index.ts         # Main server implementation  \n├── types/\n│   └── slack.ts         # TypeScript types and schemas\n└── README.md            # This file\n```\n\n## Error Handling\n\nThe server includes comprehensive error handling for:\n- Invalid webhook URLs and bot tokens\n- Network connectivity issues\n- Slack API errors (different handling for webhook vs bot)\n- Message length validation (4000 char limit)\n- Channel ID validation (bot mode)\n- Malformed requests\n\n## License\n\nMIT ","readmeFilename":"README.md"}