git clone https://github.com/Juan-Severiano/handoff-mcp
cd handoff-mcp
bun install

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

claude mcp add handoff-mcp bun /path/to/handoff-mcp/src/index.ts

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

{
  "servers": {
    "handoff-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

mcpServers:
  handoff-mcp:
    command: bun
    args:
      - /path/to/handoff-mcp/src/index.ts

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"],
      "env": { "DB_PATH": "/your/shared/path/context.db" }
    }
  }
}

Claude works on the project
→ create_or_get_project("my-app")
→ save_architecture({ description: "React Native + Spring Boot" })

Claude runs low on tokens
→ save_context_snapshot({
    llmModel: "claude-opus-4",
    taskDescription: "Implementing push notifications",
    recentChanges: "FCM handler done",
    nextSteps: "Wire up Foreground Service, test Android 16"
  })

Gemini takes over
→ get_project_summary("my-app")      # full context in one call
→ get_context_snapshot("my-app")     # picks up exactly where Claude stopped
→ continues...

bun run dev      # watch mode
bun run inspect  # MCP Inspector
bun run build    # compile to dist/