Kanbu Skill for OpenClaw
Kanbu is a self-hosted, agent-native project management platform. This skill gives you full read/write access to Kanbu via its tRPC API.
Setup
1. Install Kanbu MCP server (includes pairing CLI)
cd /path/to/kanbu && pnpm install
2. Pair with your Kanbu instance
node packages/mcp-server/dist/index.js
On first run, the MCP server starts the pairing flow:
- It displays a setup code (6 characters)
- Go to your Kanbu instance → Settings → AI Assistants → Enter the code
- The server exchanges the code for a permanent token stored in
~/.config/kanbu/mcp.json
3. Verify
scripts/kanbu.sh workspace.list
Usage
All Kanbu operations go through the kanbu.sh wrapper script:
scripts/kanbu.sh <procedure> '<json-input>'
The script auto-detects GET (queries) vs POST (mutations) and handles auth from ~/.config/kanbu/mcp.json.
Common operations
List projects:
scripts/kanbu.sh project.list '{"workspaceId": 534}'
List tasks in a project:
scripts/kanbu.sh task.list '{"projectId": 314, "workspaceId": 534}'
Get task details:
scripts/kanbu.sh task.get '{"taskId": 307, "workspaceId": 534}'
Create a task:
scripts/kanbu.sh task.create '{"projectId": 314, "title": "Implement feature X", "description": "Details here", "priority": 2, "workspaceId": 534}'
Update a task:
scripts/kanbu.sh task.update '{"taskId": 307, "title": "Updated title", "workspaceId": 534}'
Move task to a column:
scripts/kanbu.sh task.move '{"taskId": 307, "columnId": 68, "workspaceId": 534}'
Add a comment:
scripts/kanbu.sh comment.create '{"taskId": 307, "content": "Work done.", "workspaceId": 534}'
Search tasks:
scripts/kanbu.sh search.tasks '{"query": "bug", "projectId": 314, "workspaceId": 534}'
My assigned tasks:
scripts/kanbu.sh task.getAssignedToMe '{"workspaceId": 534}'
Discovering workspaceId and projectId
Always start by listing workspaces, then projects:
scripts/kanbu.sh workspace.list
scripts/kanbu.sh project.list '{"workspaceId": <id>}'
Use the returned IDs in all subsequent calls. Most procedures require workspaceId.
Priority values
- 0 = None
- 1 = Low
- 2 = Medium
- 3 = High
- 4 = Urgent
Full API Reference
For all 100+ procedures (wiki, analytics, ACL, GitHub, admin, audit, groups, etc.), read references/api-reference.md.
Tips
- workspaceId is required on almost every call
- Task identifiers (e.g.,
PROJTEMP-34) are for display; use numerictaskIdfor API calls - The script outputs
result.datadirectly as JSON — pipe tojqfor filtering - Errors are printed with full detail for debugging
- For self-signed certs (local dev), the script uses
curl -k