# Patchwork OS MCP server

> A local-first automation runtime that provides a decision layer for AI agents to safely automate tasks across GitHub, Slack, Gmail, and 45+ services.

- Repository: https://github.com/Oolab-labs/patchwork-os
- Page: https://hostedmcp.org/servers/oolab-labs/patchwork-os
- Transport: stdio
- Stars: 33
- License: MIT

## Install

### Claude Code

```sh
claude mcp add patchwork-os -- npx -y patchwork-os
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "patchwork-os": {
      "command": "npx",
      "args": [
        "-y",
        "patchwork-os"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "patchwork-os": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "patchwork-os"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "patchwork-os": {
      "command": "npx",
      "args": [
        "-y",
        "patchwork-os"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.patchwork-os]
command = "npx"
args = ["-y", "patchwork-os"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "patchwork-os": {
      "command": "npx",
      "args": [
        "-y",
        "patchwork-os"
      ]
    }
  }
}
```

## FAQ

### How does the approval process work?

Risky actions are classified by blast radius and placed in an approval queue where you can review the evidence, what will run, and the potential impact before deciding.

### Is my data uploaded to a server?

No, the runtime, recipes, workers, credentials, and decision logs are all stored locally on your machine under ~/.patchwork/.

### What happens if I need to stop all agent actions immediately?

You can use the 'patchwork panic' command to immediately block every write-tier tool call across all running bridges.