diff --git a/Kanboard.md b/Kanboard.md
new file mode 100644
index 0000000..abb7015
--- /dev/null
+++ b/Kanboard.md
@@ -0,0 +1,60 @@
+# Kanboard
+
+Kanban task boards. Tasks can be assigned to **Claude**, which fetches, works,
+comments and moves cards like a regular team member via the `agap-mcp` server.
+
+## Service
+
+- Image: `kanboard/kanboard:latest`, container `kanboard`
+- Compose: `/home/alvis/agap_git/kanboard/docker-compose.yml`
+- Port: `127.0.0.1:4800` → `:80` (reverse-proxied via Caddy externally)
+- Storage: SQLite in the `kanboard_data` volume (`/var/www/app/data/db.sqlite`)
+
+## API
+
+JSON-RPC at `/jsonrpc.php`. Two auth modes:
+
+- **App-wide (admin):** HTTP Basic `jsonrpc:<token>` — full access to every
+  project. Token lives in the DB `settings` table (`option='api_token'`) and is
+  stored in Vaultwarden as **`KANBOARD_TOKEN`**.
+- **Per-user:** `<username>:<personal-token>` — scoped to that user.
+
+```bash
+curl -s -u "jsonrpc:$KANBOARD_TOKEN" http://localhost:4800/jsonrpc.php \
+  -d '{"jsonrpc":"2.0","method":"getAllProjects","id":1}'
+```
+
+## Claude bot user
+
+- User `claude` (display **Claude**), role `app-admin`, web password in
+  Vaultwarden as **`KANBOARD_CLAUDE_PASSWORD`**.
+- **Gotcha:** app-admin grants *visibility* only. To be **assignable** a user
+  must be a **project member** — `claude` is added as `project-member` to every
+  project via `addProjectUser(project_id, user_id, "project-member")`.
+- Assign a card to `claude` (in the UI or `kanboard_assign_task`) and it shows up
+  in `kanboard_my_tasks`.
+
+## agap-mcp integration
+
+Implemented in `agap-mcp` (`src/kanboard.js`, registered in `src/server.js`).
+Authenticates with the app-wide `KANBOARD_TOKEN`; writes (comments, tasks,
+subtasks) are authored as `claude` via `user_id`. Env: `KANBOARD_URL`,
+`KANBOARD_BOT_USER=claude`.
+
+Tools (`mcp__agap__kanboard_*`):
+
+| Tool | Purpose |
+|------|---------|
+| `list_projects` / `get_project` | projects; columns + swimlanes |
+| `list_tasks` / `my_tasks` | tasks in a project / assigned to claude (all projects) |
+| `get_task` | task + subtasks + comments |
+| `search_tasks` | Kanboard query syntax (`assignee:`, `status:`, `due:`) |
+| `list_users` / `project_activity` | monitor users / activity stream |
+| `create_task` / `update_task` | create / edit |
+| `move_task` / `change_task_status` | move column / open-close |
+| `assign_task` | (re)assign to a user |
+| `add_comment` | comment as claude |
+| `create_subtask` / `update_subtask` | track execution steps (0 todo/1 wip/2 done) |
+| `remove_task` / `remove_comment` | delete (irreversible) |
+
+Deleting whole projects is intentionally not exposed.