kenzotp/mcp-server-zuuna

**Agent-native board access for Zuuna** — a
Model Context Protocol server that lets coding agents
(Claude Code, Cursor, Codex) read and work a Zuuna board directly.
> Agents work the board. Git keeps it honest.
>
> The agent reads the board via this MCP server, does the work in the repo with its own
> coding tools, and when the PR merges, a rule on your Zuuna board moves the card. Zuuna
> provides the interface and the verifiable board truth — the agent writes the code, not Zuuna.
Status
Working and tested, and **published on npm** (npx -y mcp-server-zuuna) after an auth
review of the token model, scopes and tool surface. Run from source (bottom) if you want
to hack on it.
Hosted alternative
The same 73 tools are also available with nothing to install: Zuuna runs a hosted MCP
connector at app.zuuna.de/mcp (OAuth sign-in, Developer plan).
Point Claude Code, Cursor or Codex at that URL directly and skip the token and the npx
line below. This package exists for the case that does need a local process: a CI runner,
an air-gapped agent, or a workflow that wants a plain bearer token instead of an OAuth
sign-in. See Kanban board for AI agents
for both routes side by side.
Tools
73 tools, grouped by area. Every tool works with any valid token; the Scopes column lists
what else the token must carry. The 8 marked **destructive** refuse to run without an
explicit confirm: true argument.
Identity
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_me | GET /api/v1/me | none |
Groups
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_list_groups | GET /api/v1/groups | boards:read |
| zuuna_list_group_members | GET /api/v1/groups/{groupId}/members | boards:read |
| zuuna_list_epics | GET /api/v1/groups/{groupId}/epics | boards:read |
| zuuna_create_epic | POST /api/v1/groups/{groupId}/epics | cards:write |
| zuuna_update_epic | PATCH /api/v1/groups/{groupId}/epics/{epicId} | cards:write |
| zuuna_list_group_cards | GET /api/v1/groups/{groupId}/cards | cards:read |
Boards
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_boards | GET /api/v1/boards | boards:read |
| zuuna_board | GET /api/v1/boards/{id}/columns + GET /api/v1/boards/{id}/cards | boards:read, cards:read |
| zuuna_create_board | POST /api/v1/boards | boards:write |
| zuuna_list_columns | GET /api/v1/boards/{boardId}/columns | boards:read |
| zuuna_list_board_fields | GET /api/v1/boards/{boardId}/fields | boards:read |
| zuuna_create_column | POST /api/v1/boards/{boardId}/columns | boards:write |
| zuuna_list_automations | GET /api/v1/boards/{boardId}/automations | boards:read |
Cards
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_card | GET /api/v1/cards/{idOrKey} | cards:read |
| zuuna_list_board_cards | GET /api/v1/boards/{boardId}/cards | cards:read |
| zuuna_search_cards | GET /api/v1/cards | cards:read |
| zuuna_create_card | POST /api/v1/boards/{boardId}/cards | cards:write |
| zuuna_create_cards | POST /api/v1/boards/{boardId}/cards ({"cards":[...]}) | cards:write |
| zuuna_update_card | PATCH /api/v1/cards/{idOrKey} | cards:write |
| zuuna_move_card | PATCH /api/v1/cards/{idOrKey} | cards:write |
| zuuna_move_card_to_board | POST /api/v1/cards/{cardId}/move | cards:write |
| zuuna_archive_card | POST /api/v1/cards/{cardId}/archive | cards:write |
| zuuna_unarchive_card | DELETE /api/v1/cards/{cardId}/archive | cards:write |
| zuuna_delete_card **(destructive)** | DELETE /api/v1/cards/{cardId} | cards:write |
| zuuna_restore_card | POST /api/v1/cards/{cardId}/restore | cards:write |
Comments
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_list_comments | GET /api/v1/cards/{cardId}/comments | comments:read |
| zuuna_comment | POST /api/v1/cards/{cardId}/comments | comments:write |
Checklist
| Tool | Method + path | Scopes |
|---|---|---|
| zuuna_list_checklist | GET /api/v1/cards/{cardId}/checklist | cards:read |
| zuuna_add_checklist_item | POST /api/v1/cards/{cardId}/checklist | cards:write |