@37bytes/vikunja-mcp
v1.0.4
Published
37bytes fork of the Vikunja MCP server for task management and manager workflows
Readme
37bytes Vikunja MCP
MCP server for Vikunja. Fork of aimbitgmbh/vikunja-mcp, MIT.
Capabilities
- Tasks: CRUD, complete, assign, bulk update; "mine" and "across all projects" filters.
- Projects: CRUD, archive, duplicate.
- Labels: CRUD, attach/detach on tasks, bulk set on task.
- Comments on tasks: CRUD.
- Assignees on tasks: list, add (single/bulk), remove.
- Relations between tasks: create, delete.
- Project views: CRUD.
- Kanban buckets: list, create, update, delete, list bucket tasks, move tasks between buckets.
- Saved filters: get, create, update, delete.
- Notifications: list, get, delete.
- Subscriptions: get, create, delete.
- Users search; server info.
- Manager workflows (separate binary): query-based assignment, batch assign / fetch / complete / archive.
Full tool reference: docs/tools.md.
Install
Requires Node >= 22 and a Vikunja API token (Settings → API Tokens; VIKUNJA_URL must end with /api/v1). Register the server with your client:
Claude Code:
claude mcp add vikunja --scope user \
--env VIKUNJA_URL=https://vikunja.example.com/api/v1 \
--env VIKUNJA_API_TOKEN=your-api-token \
-- npx -y @37bytes/vikunja-mcpOpenCode: opencode mcp add (interactive), use command npx -y @37bytes/vikunja-mcp.
Codex CLI:
codex mcp add vikunja \
--env VIKUNJA_URL=https://vikunja.example.com/api/v1 \
--env VIKUNJA_API_TOKEN=your-api-token \
-- npx -y @37bytes/vikunja-mcpManager binary (add-on)
A separate vikunja-mcp-manager binary exposes multi-item workflows: query-based assignment, batch assign / fetch / complete / archive. Install it alongside vikunja-mcp, not instead of it — the manager binary is an add-on. It does not include task or project CRUD, and reuses users_search from the ordinary binary.
Claude Code:
claude mcp add vikunja-manager --scope user \
--env VIKUNJA_URL=https://vikunja.example.com/api/v1 \
--env VIKUNJA_API_TOKEN=your-api-token \
-- npx -y --package=@37bytes/vikunja-mcp vikunja-mcp-managerOpenCode: opencode mcp add (interactive), use command npx -y --package=@37bytes/vikunja-mcp vikunja-mcp-manager.
Codex CLI:
codex mcp add vikunja-manager \
--env VIKUNJA_URL=https://vikunja.example.com/api/v1 \
--env VIKUNJA_API_TOKEN=your-api-token \
-- npx -y --package=@37bytes/vikunja-mcp vikunja-mcp-managerPermissions
The server delegates to Vikunja API token scopes. Recommended for daily use: projects, tasks, labels with read/create/update; notifications with read/update. Add delete only if the agent should delete data. Vikunja returns 403 when a scope is missing.
License
MIT. © aimbit GmbH and 37bytes. See LICENSE.
