Slack Notifications MCP Server

MCP server that allows Claude to check Xcode Cloud build status and interact with Slack channels.

Features

check_build_status - Get latest Xcode Cloud build notifications
get_channel_messages - Read recent messages from any channel
search_messages - Search for specific build info (requires search:read scope)
send_message - Post messages to Slack
list_channels - List available channels

Setup

1. Create Slack App

Go to https://api.slack.com/apps
Click "Create New App" → "From scratch"
Name it (e.g., "Claude MCP") and select your workspace

2. Configure Bot Token Scopes

Go to OAuth & Permissions → Scopes → Bot Token Scopes and add:

channels:history - Read messages in public channels
channels:read - List channels
groups:history - Read messages in private channels (if needed)
groups:read - List private channels (if needed)
chat:write - Send messages
search:read - Search messages (optional)

3. Install App to Workspace

Go to Install App in sidebar
Click "Install to Workspace"
Copy the Bot User OAuth Token (starts with xoxb-)

4. Get Channel ID

Open Slack in browser
Go to your build notifications channel
The URL will be like: https://app.slack.com/client/TXXXXX/CXXXXXXX
The C... part is your channel ID

5. Invite Bot to Channel

In Slack, go to the channel and type:

/invite @Claude MCP

(or whatever you named your app)

6. Configure Claude Code

Add to ~/.mcp.json (create if it doesn't exist):

{
  "mcpServers": {
    "slack-notifications": {
      "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"
      }
    }
  }
}

7. Restart Claude Code

# Exit and restart Claude Code for MCP changes to take effect

Usage

Once configured, Claude can use these tools:

# Check latest builds
mcp__slack-notifications__check_build_status()

# Get channel messages
mcp__slack-notifications__get_channel_messages(channel_id: "C...", limit: 10)

# Search for failed builds
mcp__slack-notifications__search_messages(query: "build failed")

# Send a message
mcp__slack-notifications__send_message(text: "Build complete!")

Xcode Cloud Setup

To send build notifications to Slack:

Go to App Store Connect → Xcode Cloud
Select your workflow → Post-Actions
Add Slack notification
Configure to post to your build channel

Troubleshooting

"missing_scope" error

Add the required scope in your Slack App settings under OAuth & Permissions.

"channel_not_found" error

Make sure the bot is invited to the channel (/invite @BotName).

No messages returned

Check that SLACK_BUILD_CHANNEL_ID is correct and the bot has access.