claude-collab-mcp

# claude-collab-mcp MCP server for async collaboration between two Claude users via shared project state. Two people using Claude (Claude Code, Claude Desktop, or any MCP-compatible client) can share live project context through a Supabase backend. No cloud hosting required. ## Installation ```bash # Using uvx (recommended, no install needed) uvx claude-collab-mcp # Or install with pip pip install claude-collab-mcp # Or install with uv uv pip install claude-collab-mcp ``` ## Setup ### 1. Create a Supabase Project 1. Go to [supabase.com](https://supabase.com) and create a free project 2. Run the schema setup in your Supabase SQL editor (see [setup.sql](setup.sql)) 3. Copy your project URL and anon key from Settings > API ### 2. Configure Environment Variables Each user needs three environment variables: ```bash SUPABASE_URL=https://your-project.supabase.co SUPABASE_KEY=your-anon-key COLLAB_USER=kelly # or justin, or any identifier ``` ### 3. Add to Your Claude Client **Claude Code:** ```bash claude mcp add claude-collab -s user -e SUPABASE_URL=https://... -e SUPABASE_KEY=... -e COLLAB_USER=kelly -- uvx claude-collab-mcp ``` **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "claude-collab": { "command": "uvx", "args": ["claude-collab-mcp"], "env": { "SUPABASE_URL": "https://your-project.supabase.co", "SUPABASE_KEY": "your-anon-key", "COLLAB_USER": "justin" } } } } ``` ## Tools ### Core Collaboration | Tool | Purpose | |------|---------| | `get_project_state(project_name)` | Full snapshot: open tasks, handoffs, decisions, context | | `update_task(project_name, title, ...)` | Create or update task (upsert by title) | | `post_handoff(project_name, to_user, title, context)` | Async handoff with rich context | | `get_handoffs(user?)` | Pending handoffs, auto-acknowledges yours | | `log_decision(project_name, decision, rationale)` |…