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

# List all projects
uv run {baseDir}/scripts/vikunja.py projects

# Get project details
uv run {baseDir}/scripts/vikunja.py project <ID>

# Create a project
uv run {baseDir}/scripts/vikunja.py create-project "Project Name" -d "Description"

Tasks

# List all tasks
uv run {baseDir}/scripts/vikunja.py tasks

# List tasks in a specific project
uv run {baseDir}/scripts/vikunja.py tasks --project <PROJECT_ID>

# Create a task
uv run {baseDir}/scripts/vikunja.py create-task "Task title" --project <ID> --due 2026-01-15 --priority 3

# Mark task complete
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

# Create a project for Q1 planning
uv run {baseDir}/scripts/vikunja.py create-project "Q1 2026 Planning" -d "Quarterly planning tasks"

# Add a high-priority task
uv run {baseDir}/scripts/vikunja.py create-task "Review budget" --project 5 --due 2026-01-20 --priority 3

# Check what's due
uv run {baseDir}/scripts/vikunja.py tasks --project 5 --json