Slack Notifications

Provides Slack-based build notifications and channel interaction for Claude via MCP.

javascript

1

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "stig-johnny-slack-notifications-mcp": {
      "command": "node",
      "args": [
        "/Users/post/.claude/mcp-servers/slack-notifications/index.js"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token-here",
        "SLACK_BUILD_CHANNEL_ID": "C01234567890"
      }
    }
  }
}

This Slack Notifications MCP Server lets Claude check Xcode Cloud build status, read and search channel messages, and post updates to Slack channels. It provides a straightforward way to monitor builds and keep your team informed directly from Claude.

How to use

You interact with the server through an MCP client. The server exposes a set of tools you can call from Claude to check builds, read messages, search messages, and send messages. Use the available functions to automate slack-based build notifications and channel activity.

How to install

Prerequisites: you need Node.js installed on your system.

Create a project directory for the MCP server configuration and code.
Ensure Claude can access your filesystem path where the MCP server script will live.
Add the MCP server configuration as shown in the snippet below to your Claude configuration.
Restart Claude so the MCP changes take effect.
Verify the server is running by invoking its tools from Claude.

Configuration and usage notes

MCP server configuration is defined as a stdio MCP script that runs locally. The required runtime command and arguments are shown in the configuration example. You can replace the placeholder values with your real tokens and channel IDs.

Environment variables shown here are required for the server to operate. Keep tokens secure and do not publish them.

If you need to invite Claude to your Slack channel, use the standard Slack invite flow for bots.

Troubleshooting

Missing or insufficient scopes in Slack can cause permission errors. Ensure your bot has the required scopes and is invited to the target channels.

If you see channel_not_found, confirm the bot is invited to the channel and that the channel ID is correct.

If no messages are returned, check that the channel ID is correct and that the bot has access to read channel history.

Notes

The MCP server is configured to run locally as a stdio process. The configuration example below shows the exact command, arguments, and environment needed to start the server.

Available tools

check_build_status

Get the latest Xcode Cloud build notifications to determine the current build status.

get_channel_messages

Read recent messages from a specified Slack channel.

search_messages

Search messages in Slack channels for specific build-related information (requires search:read scope).

send_message

Post messages to a Slack channel.

list_channels

List available Slack channels accessible by the bot.