Skill: sanban

Simple kanban that just works. JSON-backed boards with REST API + MCP server.

When to Use

• User wants to track tasks, issues, or work items
• Agent needs to create/update/list kanban items programmatically
• User asks for a lightweight project tracker (no Jira/Linear/Notion)
• Multi-board project management from CLI or browser

Quick Start

uv tool install .
sanban              # web server on http://localhost:8900

Connection Method: REST API

Use when: running in browser, curl available, or agent prefers HTTP requests.

Setup

sanban              # starts REST server on http://localhost:8900

Base URL

http://localhost:8900/api

Endpoints

Examples

Create board:

curl -X POST http://localhost:8900/api/boards \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-board"}'

Rename / update columns:

curl -X PATCH http://localhost:8900/api/boards/<board_id> \
  -H 'Content-Type: application/json' \
  -d '{"name":"new-name","columns":["todo","doing","done"]}'

Duplicate board:

curl -X POST http://localhost:8900/api/boards/<board_id>/duplicate \
  -H 'Content-Type: application/json' \
  -d '{"name":"copy-of-board"}'

Add item:

curl -X POST http://localhost:8900/api/boards/<board_id>/items \
  -H 'Content-Type: application/json' \
  -d '{"title":"Fix bug","priority":"high","effort":"S"}'

Move item:

curl -X PATCH http://localhost:8900/api/boards/<board_id>/items/<item_id> \
  -H 'Content-Type: application/json' \
  -d '{"status":"done"}'

Export board as CSV:

curl 'http://localhost:8900/api/boards/<board_id>/export?format=csv' -o board.csv

Import board:

curl -X POST http://localhost:8900/api/import \
  -H 'Content-Type: application/json' \
  -d '{"name":"imported","columns":["todo","done"],"items":[{"title":"One","status":"todo"}]}'

Activity history:

curl 'http://localhost:8900/api/boards/<board_id>/history?limit=20'

Connection Method: MCP

Use when: agent has MCP tools available, prefer direct tool calls over HTTP.

Setup

{
  "mcpServers": {
    "sanban": {
      "command": "sanban",
      "args": ["--mcp-only"]
    }
  }
}

MCP Tools

Item Fields

Data Location

~/.sanban/boards/<id>.json — one JSON file per board. Activity log: ~/.sanban/history/<id>.json (capped at 500 entries). Override both with SANBAN_DATA_DIR.

Markdown Support

Titles and descriptions render markdown: **bold**, *italic*, ` code , links, - lists, # headings`.

Keyboard Shortcuts (Web UI)

Server CLI

sanban [--host HOST] [--port PORT] [--mcp-only] [--rest-only]