Slack Notify
About
Send notifications to Slack using OAuth bot tokens.
Details
- Author
- mkusaka
- Categories
- Communication, Other
Jump to
Setup
Install Slack Notify in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/mkusaka/mcp-server-slack-notify
Follow the installation instructions in the repository README, then restart your MCP client.
MCP server for sending notifications to Slack using OAuth bot tokens.
- Send formatted messages to Slack channels with title and description
- Mention specific users automatically with the mention parameter
- Support for Slack's markdown formatting
- Clean message formatting with optional header
- TypeScript support with full type safety
npm install @mkusaka/mcp-server-slack-notify # or pnpm add @mkusaka/mcp-server-slack-notify
- In your app settings, navigate to "OAuth & Permissions" in the sidebar
- Scroll down to "Scopes" section
- Under "Bot Token Scopes", click "Add an OAuth Scope"
- Add the following scope:
- chat:write- Required for sending messages
- Stay on the "OAuth & Permissions" page
- Click "Install to Workspace" at the top
- Review the permissions and click "Allow"
- You'll be redirected back to the OAuth & Permissions page
- After installation, you'll see a "Bot User OAuth Token" on the OAuth & Permissions page
- It starts withxoxb-
- Copy this token - you'll need it for theSLACK_BOT_TOKENenvironment variable
- In Slack, go to the channel where you want to send notifications
- Type/invite @YourBotName(replace with your bot's name)
- Or click the channel name → "Integrations" tab → "Add apps" → Select your bot
Set the following environment variables:
- SLACK_BOT_TOKEN(required): Your Bot User OAuth Token from step 4
- SLACK_DEFAULT_CHANNEL(optional): Default channel for notifications (e.g.,#general)
- SLACK_MENTIONS(optional): Default user IDs to mention in all messages (e.g.,U1234567890,U0987654321)
Add to your Claude Desktop configuration:
{ "mcpServers": { "slack-notify": { "command": "npx", "args": ["-y", "@mkusaka/mcp-server-slack-notify@latest"], "env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here", "SLACK_DEFAULT_CHANNEL": "#general", "SLACK_MENTIONS": "U1234567890,U0987654321" } } } }
You can add this MCP server to Claude Code using the following command:
claude mcp add slack-notify -e SLACK_BOT_TOKEN=xoxb-your-token-here -e SLACK_DEFAULT_CHANNEL=#general -e SLACK_MENTIONS=U1234567890,U0987654321 -- npx -y @mkusaka/mcp-server-slack-notify@latest
Or if you have the package installed globally:
# Install globally first npm install -g @mkusaka/mcp-server-slack-notify # Then add to Claude Code claude mcp add slack-notify -e SLACK_BOT_TOKEN=xoxb-your-token-here -e SLACK_DEFAULT_CHANNEL=#general -e SLACK_MENTIONS=U1234567890,U0987654321 -- mcp-server-slack-notify
To add with user scope (available across all projects):
claude mcp add --scope user slack-notify -e SLACK_BOT_TOKEN=xoxb-your-token-here -e SLACK_DEFAULT_CHANNEL=#general -e SLACK_MENTIONS=U1234567890,U0987654321 -- npx -y @mkusaka/mcp-server-slack-notify@latest
Sends a notification to a Slack channel.
- channel(optional): The Slack channel (e.g., #general or C1234567890)
- title(optional): The notification title (if provided, displays with header formatting)
- description(required): The notification body (supports Slack markdown)
- mention(optional): User ID(s) to mention. Can be a single user ID (e.g., U1234567890) or multiple IDs separated by commas (e.g., U1234567890,U0987654321)
The description field supports Slack's mrkdwn formatting:
- Mentions:
- User:<@U1234567890>(use the user's ID)
- Channel:<#C1234567890>(use the channel's ID)
- @here:<!here>
- @channel:<!channel>
- User groups:<!subteam^S1234567890>(use the subteam's ID)
- Note:When using thementionparameter orSLACK_MENTIONSenvironment variable, user mentions are automatically added at the beginning of the message
- Bold:bold text
- Italic:_italic text_
- Strikethrough:~strikethrough text~
- Code:`inline code
- Code block:code block
- Quote:> quoted text
- Link:<https://example.com|Link text>
# Install dependencies pnpm install # Run tests pnpm test # Build pnpm build # Run in development mode pnpm start # Debug with MCP Inspector pnpm debug
The project includes comprehensive tests using Vitest with mocked Slack API calls.
# Run tests pnpm test # Run tests in watch mode pnpm test:watch```
A lightweight notification service that sends webhooks for completed MCP tasks to providers like Discord, Slack, and Teams.
Unified notification MCP server with 36 tools to send messages across 23 channels — Email, SMS, Slack, Telegram, Discord, Teams, WhatsApp, Firebase Push, and more.
Post messages to Slack channels using incoming webhooks or bot tokens.
Post messages to Slack channels using incoming webhooks.
Manage notification workflows, users, preferences, and tenant branding via natural language. Trigger email, SMS, push, WhatsApp, Slack, and in-app notifications from Cursor, Claude Desktop, or Windsurf using 24 tools.
Send Push Notifications and Live Activities to your paired iOS devices.
Send native macOS notifications and interact with system dialogs.
Send iOS push notifications using the Bark app.
Slack for AI agents - a local service where agents can join projects, message each other, and share resources in a structured workspace
A read-only MCP server for Slack by CData, enabling LLMs to query live Slack data. Requires the CData JDBC Driver for Slack.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
