claude-mcp-slack-feedback by jorgeuriarte - MCP Server

Claude MCP Slack Feedback

A Model Context Protocol (MCP) server that enables Claude Code to request human feedback through Slack during task execution.

🔄 Real-time feedback: Ask questions and get responses from your team via Slack
🌐 Webhook support: Optional cloudflared tunnels for instant responses
📊 Polling mode: Default mode that works without any additional dependencies
👥 Multi-user support: Multiple developers can use simultaneously
🔀 Multi-session support: Handle multiple Claude sessions per user
🚀 Zero-configuration: Auto-detects users and creates channels

git clone https://github.com/yourusername/claude-mcp-slack-feedback.git
cd claude-mcp-slack-feedback
./scripts/install.sh

The installer will:

Clone and build:

git clone https://github.com/yourusername/claude-mcp-slack-feedback.git
cd claude-mcp-slack-feedback
npm install
npm run build

Configure Claude Desktop:

Add to ~/.config/claude/mcp-servers.json:

{
  "claude-mcp-slack-feedback": {
    "command": "node",
    "args": ["/path/to/claude-mcp-slack-feedback/dist/index.js"]
  }
}

Create app from manifest:
- Go to https://api.slack.com/apps
- Click "Create New App" → "From an app manifest"
- Select your workspace
- Choose "YAML" format
- Copy and paste the contents of slack-app-manifest.yml
- Review and create
Install to workspace:
- Click "Install to Workspace"
- Copy the Bot User OAuth Token (starts with xoxb-)

Create a Slack App:
- Go to https://api.slack.com/apps
- Click "Create New App" → "From scratch"
- Name it "Claude MCP Feedback"
- Select your workspace
Configure OAuth Scopes:

Under "OAuth & Permissions", add these Bot Token Scopes:
- channels:manage - Create and manage channels
- chat:write - Send messages
- channels:read - List channels
- users:read - Get user info
- users:read.email - Match by email
- channels:history - Read channel messages
- groups:read - Access private channels
- groups:history - Read private channel messages
- im:read - Access direct messages
- im:history - Read direct messages
- mpim:read - Access group direct messages
- mpim:history - Read group direct messages
Optional: Configure Event Subscriptions (for webhooks):
- Enable Events
- The tunnel URL will be provided when you start a session
- Subscribe to bot events:
  - message.channels
  - message.groups
  - message.im
  - message.mpim
Install to Workspace:
- Click "Install to Workspace"
- Copy the Bot User OAuth Token (starts with xoxb-)

In Claude, use the setup tool:

setup_slack_config with bot token "xoxb-your-token-here"

By default, the bot uses polling mode which works great for most users. Webhooks are optional.

If you want real-time responses via webhooks:

First time using ask_feedback:
- The system will show: 🔗 Webhook URL: https://abc123.trycloudflare.com/slack/events
- Copy this URL
Configure Slack for webhooks:
- Go to your app at https://api.slack.com/apps
- Select your app → "Event Subscriptions"
- Toggle "Enable Events" to On
- Paste the webhook URL in "Request URL"
- Wait for "Verified" ✓
- Under "Subscribe to bot events", add:
  - message.channels
  - message.groups
  - message.im
  - message.mpim
- Click "Save Changes"

Important notes about webhooks:

ask_feedback with question "Should I use TypeScript or JavaScript for this project?" and context "Building a web scraper"

get_responses

update_progress with message "Analyzed the requirements, proceeding with implementation" and thread "1234567890.123456"

list_sessions

Session Creation: When you first use ask_feedback, the system:
- Detects your user (via email or username)
- Creates a unique session
- Creates a Slack channel for the session
Communication Modes:
- Webhook Mode: If cloudflared is installed, creates a tunnel for real-time responses
- Polling Mode: Falls back to checking Slack periodically
Channel Structure:
- Main channel: #claude-username-main
- Session channels: #claude-username-sessionid

CLAUDE_USER_EMAIL: Set this to match your Slack email for automatic user detection
USER / USERNAME: Used as fallback for user detection

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

# Type check
npm run typecheck

MIT