Harness · Claude Code

Claude Code.

Claude Code has the deepest integration. You get two options: install the official Workbooks skill, which teaches Claude how to author workbooks against the standard; or wire up the MCP server, which lets Claude drive Studio (publish, revoke, list) as tool calls. Most users want both.

Auto-install

Paste this into Claude Code

Click below to copy a self-install prompt. Paste it into Claude Code and it'll run the steps itself — installing the skill, wiring up MCP, and verifying everything works.

Or follow the manual steps below.

Option A — install the skill (recommended)

The skill ships with authoring guidance, the latest CLI version, and shortcuts for common tasks. One command:

curl -fsSL https://workbooks.sh/skill | sh

Restart Claude Code. Type /workbooks to verify the skill is loaded. The skill will offer Init, Build, Publish, and authoring-help flows.

Option B — wire up MCP directly

If you'd rather not install the skill (or you want the agent to drive Studio without authoring guidance), drop this into your project's .mcp.json or your user-level config:

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

Restart Claude Code. Run /mcp to confirm workbooks is listed. You should see tools like workbooks__list_groups, workbooks__publish, etc.

Quirks & tips

Both at once is fine. The skill knows when MCP is also wired up and will prefer MCP tool calls over CLI invocations.
Auth is shared. Whichever path runs workbook publish first opens a browser for OAuth; the token is stored in your OS keychain and reused by all subsequent calls (skill or MCP).
Project-scoped works. .mcp.json at a project root is auto-loaded by Claude Code only inside that project. Useful when only some repos need Workbooks.
Skill updates are silent. Re-run the curl install when you upgrade @work.books/cli — the skill bundle ships next to CLI releases.

Verify it works

From inside Claude Code, ask:

"List my workbook groups."

Claude should call workbooks__list_groups via MCP and return your groups (or "none yet" if you haven't created any). If it can't find the tool, check that workbook --version runs from a normal shell — Claude Code needs the CLI on $PATH.