Harness · Windsurf

Windsurf.

Codeium's AI-native IDE. Cascade (Windsurf's agent) reads MCP server config from a JSON file under Codeium's settings dir.

Auto-install

Paste this into Windsurf

Click below to copy a self-install prompt. Paste it into a Cascade session and Windsurf will create the MCP config and refresh its tools for you.

Or follow the manual steps below.

npm install -g @work.books/cli

macOS / Linux:

$EDITOR ~/.codeium/windsurf/mcp_config.json

If the file doesn't exist yet, create the directory and the file.

{
  "mcpServers": {
    "workbooks": {
      "command": "workbook",
      "args": ["mcp", "serve"]
    }
  }
}

Open Cascade. Click the hammer icon (tools) at the top of the panel → Refresh MCP servers. The workbooks tool group should appear in the list.

Cascade vs Chat. MCP tools only run in Cascade (the agent), not in plain Chat. Switch modes if the agent isn't using your tools.
Settings UI. Newer Windsurf builds expose MCP config in Settings → Cascade → Plugins (instead of editing the JSON by hand). Either path edits the same file.
Network-restricted Windsurf instances. If your team uses an air-gapped Windsurf, the OAuth browser flow for workbook publish still needs network access from the host running the CLI subprocess.

Cascade: "Use workbooks to list my groups."