vikunja_api

Manage tasks, projects, labels, and filters in Vikunja via REST API.

1|Updated Sep 19, 2025
One-click install
npx skills add https://github.com/kentonium3/kg-automation --skill vikunja-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vikunja_api
Source: https://github.com/kentonium3/kg-automation/tree/main/scripts/openclaw/skills/vikunja-api
Command: npx skills add https://github.com/kentonium3/kg-automation --skill vikunja-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents need a reliable way to interact with the Vikunja task store to create, update, query, and manage tasks, projects, labels, and filters without manual API handling.

Core Features & Use Cases

  • Task CRUD: Create, read, update, complete, and delete tasks through curl commands.
  • Project & Label Resolution: Dynamically resolve project and label IDs by name to avoid hard‑coding.
  • Filters & Queries: Access built‑in pseudo‑projects like Today, Upcoming, Overdue and run custom queries.
  • Comments: Add agent‑prefixed comments to tasks for traceability. Use case: An assistant can automatically add a new “Prepare report” task to the Inbox project with the appropriate identity label after processing an email.

Quick Start

Ask the assistant to create a task titled “Prepare report” in the “Inbox” project with the “personal” label.

Frequently Asked Questions about vikunja_api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Vikunja task management through a REST API?

Automate Vikunja task management by executing curl commands via an agent's exec tool to interact with the Vikunja REST API. This allows agents to automatically create, read, update, and delete tasks without manual API handling.

How do I create a task in a specific Vikunja project using an API?

Create a task in a specific Vikunja project by resolving the project ID by name dynamically and sending a curl command to the API. You can also attach identity labels by resolving label IDs similarly to avoid hard-coding.

What do I need to authenticate Vikunja API requests from an agent?

Authenticating Vikunja API requests requires a Bearer token stored at /data/services/openclaw/secrets/vikunja-api. The agent uses this token to authorize curl commands sent to the REST API.

Can I query built-in Vikunja filters like Today and Overdue via the API?

Yes, you can query built-in Vikunja pseudo-projects like Today, Upcoming, and Overdue through the API. The Skill supports accessing these filters and running custom queries to retrieve specific task sets.

What is the best way to add traceability to automated Vikunja tasks?

Add traceability to automated Vikunja tasks by appending agent-prefixed comments to tasks via the API. This ensures that any task created or updated by an agent includes a clear record of its processing actions.