Which integrations are available for this server?

Enables bidirectional Slack communication, allowing users to send notifications with varying urgency levels, ask questions and wait for replies via Slack threads, and manage channel messages.

How do I use Slack Notifier MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Slack Notifier MCP notify me on Slack when the long-running tests are finished" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Slack Notifier MCP

Python 3.10+ MCP License: MIT

MCP server for bidirectional Slack communication with Claude Code. Get notified when tasks complete, and respond to Claude's questions directly from Slack.

Quick Start

# Add to Claude Code (one command) claude mcp add slack-notifier -s user \ -e SLACK_BOT_TOKEN=xoxb-your-token \ -e SLACK_DEFAULT_CHANNEL=C1234567890 \ -- uvx slack-notifier-mcp

Features

Notify - Send notifications when tasks complete, errors occur, or when stepping away
Ask & Wait - Ask questions and wait for replies via Slack threads
Bidirectional - Reply to Claude from Slack, get responses back in your terminal
Urgency Levels - Normal, important, and critical notifications with appropriate formatting

Slack App Setup

Before using this server, you need to create a Slack app:

Go to api.slack.com/apps and click Create New App
Choose From scratch, name it (e.g., "Claude Code"), and select your workspace
Go to OAuth & Permissions in the sidebar
Under Scopes > Bot Token Scopes, add:
- chat:write - Send messages
- channels:history - Read public channel messages
- groups:history - Read private channel messages
- im:history - Read DM messages
- users:read - Get user display names
Click Install to Workspace at the top
Copy the Bot User OAuth Token (starts with xoxb-)

To get your default channel ID:

Open Slack, right-click the channel, and select View channel details
At the bottom, copy the Channel ID (starts with C)

Installation

Claude Code (Recommended)

claude mcp add slack-notifier -s user \ -e SLACK_BOT_TOKEN=xoxb-your-token \ -e SLACK_DEFAULT_CHANNEL=C1234567890 \ -- uvx slack-notifier-mcp

VS Code

code --add-mcp '{"name":"slack-notifier","command":"uvx","args":["slack-notifier-mcp"],"env":{"SLACK_BOT_TOKEN":"xoxb-your-token","SLACK_DEFAULT_CHANNEL":"C1234567890"}}'

Other MCP Clients

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "slack-notifier": { "command": "uvx", "args": ["slack-notifier-mcp"], "env": { "SLACK_BOT_TOKEN": "xoxb-your-token", "SLACK_DEFAULT_CHANNEL": "C1234567890" } } } }

Go to Settings → MCP → Add new MCP Server
Select command type
Enter command: uvx slack-notifier-mcp
Add environment variables for SLACK_BOT_TOKEN and SLACK_DEFAULT_CHANNEL

Or add to ~/.cursor/mcp.json:

{ "mcpServers": { "slack-notifier": { "command": "uvx", "args": ["slack-notifier-mcp"], "env": { "SLACK_BOT_TOKEN": "xoxb-your-token", "SLACK_DEFAULT_CHANNEL": "C1234567890" } } } }

Any MCP-compatible client can use slack-notifier:

{ "mcpServers": { "slack-notifier": { "command": "uvx", "args": ["slack-notifier-mcp"], "env": { "SLACK_BOT_TOKEN": "xoxb-your-token", "SLACK_DEFAULT_CHANNEL": "C1234567890" } } } }

Local Development

git clone https://github.com/strand-ai/slack-notifier-mcp.git cd slack-notifier-mcp uv sync uv run slack-notifier-mcp

MCP Tools

`notify`

Send a notification to Slack.

notify( message="GPU instance is ready! SSH: ubuntu@192.168.1.100", urgency="important" # or "normal", "critical" )

Parameters:

message (required): Notification text (supports Slack mrkdwn)
channel (optional): Channel ID or name (uses default if not set)
urgency (optional): normal, important, or critical

`ask_user`

Send a question and wait for the user's reply.

ask_user( question="Should I use PostgreSQL or SQLite for the database?", context="Setting up the backend for the new API", timeout_minutes=10 ) # Returns: {"success": True, "reply": "Use PostgreSQL", ...}

Parameters:

question (required): The question to ask
channel (optional): Channel ID or name
context (optional): Additional context about what you're working on
timeout_minutes (optional): How long to wait (default 5, max 30)

`send_message`

Lower-level message sending for conversational use.

send_message( message="Done with the first step, moving on...", thread_ts="1234567890.123456" # Reply in thread )

`get_thread_replies`

Check for new replies in a thread.

get_thread_replies( channel="C1234567890", thread_ts="1234567890.123456", since_ts="1234567891.000000" # Only newer messages )

Environment Variables

Variable	Required	Description
`SLACK_BOT_TOKEN`	Yes	Bot token from Slack app (xoxb-...)
`SLACK_DEFAULT_CHANNEL`	No	Default channel for notifications

Example Usage

Tell Claude Code:

"Notify me on Slack when the tests finish running"

"Ask me on Slack whether to proceed with the database migration"

"Send a Slack notification if any errors occur while I'm away"

Debugging

Run the MCP inspector to test tools:

npx @anthropics/mcp-inspector uvx slack-notifier-mcp

Check if your token works:

curl -H "Authorization: Bearer xoxb-your-token" \ https://slack.com/api/auth.test

Development

# Install with dev dependencies uv sync --extra dev # Run tests uv run pytest # Format code uv run black slack_mcp uv run ruff check slack_mcp --fix

License

MIT

Slack Notifier MCP

Slack Notifier MCP

Quick Start

Features

Slack App Setup

Installation

Claude Code (Recommended)

VS Code

Other MCP Clients

Local Development

MCP Tools

`notify`

`ask_user`

`send_message`

`get_thread_replies`

Environment Variables

Example Usage

Debugging

Development

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API