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.
Use this skill to call Kaizen OS MCP endpoints from shell scripts.
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
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"
tools to discover servers and tool names.call <server> <tool> --arg key=value to execute a tool.--raw to print the unformatted JSON response.| 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 |
OpenClaw managed configuration example:
{
skills: {
entries: {
"kaizen-os": {
apiKey: "kaizen_sk_...",
env: {
KAIZEN_BASE_URL: "https://kaizen.gehirn.ai",
},
},
},
},
}
--arg accepts key=value pairs.true, false), null, and numbers.Example:
{baseDir}/scripts/kaizen.sh call kaizen-db create_card \
--arg title="Launch checklist" \
--arg unitType=ACTION_EXPERIMENT \
--arg criteria='["Tests green", "Docs updated"]'
See references/mcp-api.md for endpoint contract, error codes, and full tool argument reference.