| name | vikunja |
| description | Manage projects and tasks in Vikunja, an open-source project management tool. Create projects, tasks, set due dates, priorities, and track completion. |
| homepage | https://vikunja.io |
| metadata | {"clawdbot":{"emoji":"📋","requires":{"bins":["uv"],"env":["VIKUNJA_URL","VIKUNJA_USER","VIKUNJA_PASSWORD"]},"primaryEnv":"VIKUNJA_URL"}} |
Vikunja Project Management
Manage projects and tasks in Vikunja, an open-source, self-hosted project management tool.
Setup
Set these environment variables:
VIKUNJA_URL - Your Vikunja instance URL (e.g., https://vikunja.example.com)
VIKUNJA_USER - Username or email
VIKUNJA_PASSWORD - Password
Commands
Projects
uv run {baseDir}/scripts/vikunja.py projects
uv run {baseDir}/scripts/vikunja.py project <ID>
uv run {baseDir}/scripts/vikunja.py create-project "Project Name" -d "Description"
Tasks
uv run {baseDir}/scripts/vikunja.py tasks
uv run {baseDir}/scripts/vikunja.py tasks --project <PROJECT_ID>
uv run {baseDir}/scripts/vikunja.py create-task "Task title" --project <ID> --due 2026-01-15 --priority 3
uv run {baseDir}/scripts/vikunja.py complete <TASK_ID>
Options
--json - Output results as JSON (for programmatic use)
Priority Levels
- 0: None
- 1: Low
- 2: Medium
- 3: High
- 4: Urgent
- 5: Critical
Examples
uv run {baseDir}/scripts/vikunja.py create-project "Q1 2026 Planning" -d "Quarterly planning tasks"
uv run {baseDir}/scripts/vikunja.py create-task "Review budget" --project 5 --due 2026-01-20 --priority 3
uv run {baseDir}/scripts/vikunja.py tasks --project 5 --json