kaizen-os - SKILL.md Agent Skill

name: kaizen-os description: Interact with Kaizen OS via MCP API to manage cards, workitems, scratchpad notes, and calendar events. Use when tasks involve planning, personal productivity, or scheduling. metadata: openclaw: requires: bins: - curl - jq env: - KAIZEN_API_KEY primaryEnv: KAIZEN_API_KEY

Kaizen OS MCP

Use this skill to call Kaizen OS MCP endpoints from shell scripts.

Setup

Set credentials in environment variables, or place them in {baseDir}/.env.

export KAIZEN_API_KEY="kaizen_sk_..."
export KAIZEN_BASE_URL="https://kaizen.gehirn.ai"

KAIZEN_BASE_URL is optional. Default is https://kaizen.gehirn.ai.

Generate API keys in Kaizen OS at:

Settings -> API Keys -> Create New Key

Quick Start

List available tools:

{baseDir}/scripts/kaizen.sh tools

List cards:

{baseDir}/scripts/kaizen.sh call kaizen-db list_cards

Create a card:

{baseDir}/scripts/kaizen.sh call kaizen-db create_card \
  --arg title="Ship v2 release" \
  --arg unitType=ACTION_GATE

Get workitems for a date range:

{baseDir}/scripts/kaizen.sh call workitems list_workitems \
  --arg startDate="2026-02-10" \
  --arg endDate="2026-02-10"

Read scratchpad:

{baseDir}/scripts/kaizen.sh call scratchpad get_scratchpad

Append scratchpad content:

{baseDir}/scripts/kaizen.sh call scratchpad update_scratchpad \
  --arg content="## Meeting Notes" \
  --arg append=true

Create a calendar event:

{baseDir}/scripts/kaizen.sh call calendar create_calendar_event \
  --arg summary="Team standup" \
  --arg start="2026-02-11T09:00:00-08:00" \
  --arg end="2026-02-11T09:30:00-08:00"

Workflow

Run tools to discover servers and tool names.
Run call <server> <tool> --arg key=value to execute a tool.
Add --raw to print the unformatted JSON response.

Server Reference

Server	Purpose	Key Tools
`kaizen-db`	Cards and seasons	`list_cards`, `create_card`, `update_card`, `delete_card`, `get_active_season`
`workitems`	Google Tasks integration	`list_workitems`, `create_workitem`, `complete_workitem`
`scratchpad`	Markdown notes	`get_scratchpad`, `update_scratchpad`, `clear_scratchpad`
`calendar`	Calendar events	`create_calendar_event`, `update_calendar_event`, `delete_calendar_event`

Config

OpenClaw managed configuration example:

{
  skills: {
    entries: {
      "kaizen-os": {
        apiKey: "kaizen_sk_...",
        env: {
          KAIZEN_BASE_URL: "https://kaizen.gehirn.ai",
        },
      },
    },
  },
}

Argument Notes

--arg accepts key=value pairs.
Values auto-convert to JSON booleans (true, false), null, and numbers.
To pass arrays/objects, provide valid JSON in the value.

Example:

{baseDir}/scripts/kaizen.sh call kaizen-db create_card \
  --arg title="Launch checklist" \
  --arg unitType=ACTION_EXPERIMENT \
  --arg criteria='["Tests green", "Docs updated"]'

References

See references/mcp-api.md for endpoint contract, error codes, and full tool argument reference.