# Vikunja

> Manage projects and tasks in Vikunja, an open-source project management tool. Create projects, tasks, set due dates, priorities, and track completion.

- Skill: `kbarbel640-del/vikunja` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/vikunja`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/vikunja/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/vikunja

---


# Vikunja Project Management

Manage projects and tasks in [Vikunja](https://vikunja.io), 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
```bash
# 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
```bash
# 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

```bash
# 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
```