Slunk - Real-time Slack Search for macOS
Slunk monitors Slack in real-time and provides intelligent search through an MCP server integration with Claude Desktop.
Features
- 🔍 Real-time monitoring - Captures Slack messages using accessibility API
- 🧠 Semantic search - Apple's NLEmbedding for conceptual matching
- 💾 Local storage - SQLite with automatic deduplication and 2-month retention
- 🤖 8 MCP tools - Natural language search, analytics, and pattern discovery
- 🔒 Privacy-first - All data stays on your machine
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"]
}
}
}
MCP Tools
| Tool | Purpose |
|---|---|
searchConversations | Natural language search across all messages |
search_messages | Precise filtering by channel/user/date |
get_thread_context | Extract complete thread conversations |
get_message_context | Decode short messages and emojis |
parse_natural_query | Extract intent from queries |
conversational_search | Multi-turn search sessions |
discover_patterns | Find trending topics |
suggest_related | Discover related conversations |
Architecture
- GUI Mode: Menu bar app that monitors Slack
- MCP Mode: JSON-RPC server for Claude integration
- Database: SQLiteVec with 512-dimensional embeddings
- Storage:
~/Library/Application Support/Slunk/
Development
See CLAUDE.md for detailed development instructions.
License
MIT