vikunja

clawdbot's avatarfrom clawdbot

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

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026
[Project Management]

When & Why to Use This Skill

This Claude skill provides a robust integration with Vikunja, the premier open-source project management tool. It enables users to streamline their workflow by managing projects, tasks, and deadlines through natural language commands. By bridging the gap between AI and self-hosted productivity suites, it helps teams maintain organized task lists, set priorities, and track project completion efficiently within their AI workspace.

Use Cases

  • Rapid Task Creation: Instantly add tasks to specific projects with due dates and priority levels using simple natural language instructions.
  • Project Oversight: Retrieve comprehensive lists of tasks or project details to get a quick status update on ongoing initiatives.
  • Priority Management: Dynamically adjust task priorities from 'Low' to 'Critical' to ensure the team focuses on the most impactful work.
  • Workflow Automation: Seamlessly transition from planning to execution by creating new projects and populating them with initial action items in one go.
  • Task Completion Tracking: Mark tasks as finished and maintain an up-to-date record of progress without manual data entry in the Vikunja UI.
namevikunja
descriptionManage projects and tasks in Vikunja, an open-source project management tool. Create projects, tasks, set due dates, priorities, and track completion.
homepagehttps://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

# 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