Slunk MCP

🚀 Slunk - Real-time Slack Search for macOS

Slunk monitors Slack in real-time and offers intelligent search through an MCP server integration with Claude Desktop, enabling users to quickly find relevant information in Slack.

🚀 Quick Start

Prerequisites

• macOS 13.0+
• Xcode 15.0+
• Slack desktop app

Build & Run

# Build
cd slunk-swift
xcodebuild -project slunk-swift.xcodeproj -scheme slunk-swift -configuration Release build

# Run GUI (menu bar app)
open ~/Library/Developer/Xcode/DerivedData/slunk-swift-*/Build/Products/Release/slunk-swift.app

# Configure Claude Desktop
# Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "slunk-swift": {
      "command": "/path/to/slunk-swift.app/Contents/MacOS/slunk-swift",
      "args": ["--mcp"]
    }
  }
}

✨ Features

• 🔍 Real-time monitoring: Captures Slack messages using accessibility API.
• 🧠 Semantic search: Utilizes Apple's NLEmbedding for conceptual matching.
• 💾 Local storage: Employs SQLite with automatic deduplication and 2-month retention.
• 🤖 8 MCP tools: Supports natural language search, analytics, and pattern discovery.
• 🔒 Privacy-first: All data stays on your machine.

📦 MCP Tools

🔧 Architecture

• GUI Mode: A menu bar app that monitors Slack.
• MCP Mode: A JSON - RPC server for Claude integration.
• Database: SQLiteVec with 512 - dimensional embeddings.
• Storage: ~/Library/Application Support/Slunk/

📚 Documentation

See CLAUDE.md for detailed development instructions.

📄 License

This project is licensed under the MIT license.