Connect your AI agent to any Vikunja instance to manage tasks, projects, and labels via a comprehensive REST API integration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vikunja-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install vikunja-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Vikunja Task Management?
The Vikunja skill for Openclaw Skills provides a robust bridge between your AI coding agent and your personal or team task management instance. By interfacing directly with the Vikunja REST API (v1), this skill allows agents to perform complex organizational tasks without manual intervention. It utilizes API token authentication to ensure secure and persistent access to your productivity data.
Built to handle the nuances of the Vikunja platform, this skill enables Openclaw Skills to navigate specific HTTP verb conventions where PUT is used for resource creation and POST for updates. This ensures that your AI agent can accurately reflect the state of your projects, whether you are running a cloud-based instance or a self-hosted homelab setup.
Vikunja Task Management Use Cases
- Creating and organizing tasks within specific projects using natural language.
- Querying upcoming deadlines and filtering tasks by priority or due date.
- Managing project taxonomies through the creation and assignment of labels.
- Automating the assignment of tasks to users and setting relative or absolute reminders.
- Visualizing and managing task dependencies and relations such as subtasks or blockers.
How Vikunja Task Management Works
- The agent first verifies that the VIKUNJA_BASE_URL and VIKUNJA_API_TOKEN environment variables are correctly configured.
- When a user provides a command, the skill resolves human-readable names (like project titles) to their specific internal IDs.
- The skill constructs an authenticated request to the Vikunja API using the appropriate HTTP verb (PUT for new items, POST for modifications).
- For list operations, the skill automatically processes pagination headers to ensure all relevant data is captured.
- The agent interprets the JSON response from the server and presents a structured, human-readable summary back to the user.
Vikunja Task Management Setup
To enable this skill within your Openclaw Skills environment, you must configure the following environment variables:
# The base URL of your Vikunja instance
export VIKUNJA_BASE_URL="https://vikunja.your-domain.com"
# Your personal API token generated in Settings -> API Tokens
export VIKUNJA_API_TOKEN="your_secure_api_token"
Vikunja Task Management Data Schema & Taxonomy
The skill organizes data based on the Vikunja v1 API schema. Below is a summary of the primary data objects handled:
| Object | Key Attributes | Workflow |
|---|---|---|
| Projects | ID, Title, Description | Resolved via list before task creation |
| Tasks | ID, Title, Priority, Done Status | Managed via PUT (create) and POST (update) |
| Labels | ID, Title, Hex Color | Associated with tasks via separate relation endpoints |
| Relations | Task ID, Relation Type | Used for subtasks, dependencies, and blocking |
| Reminders | Absolute/Relative Time | Managed as part of the task update payload |
Vikunja Task Management Advanced Features
- Intelligent Name Resolution: Automatically converts project and label names into IDs before execution.
- Complex Relations Support: Programmatically link tasks with 'precedes', 'follows', or 'subtask' designations.
- Native Pagination Handling: Utilizes x-pagination headers to manage large datasets across multiple API calls.
- Batch Metadata Management: Update task priority, percent done, and labels in a single logical workflow.
- Detailed Error Reporting: Surfaces specific API error messages to help troubleshoot token or permission issues.
SKILL.md
Loading
Related Openclaw Skills
JoeVault
JoeVault is a specialized utility for auditing, classifying, and archiving stale file paths and inactive system states without disrupting live production environments.
D&D Character Art Generator
A specialized AI tool for creating high-fidelity, cinematic tabletop RPG character portraits and tokens via the Neta AI API.
SEO Ladders
A comprehensive SEO automation engine that handles technical audits, keyword research, and high-quality article generation directly within your AI-powered development environment.
Chenyu AIGC: AI Video and Image Generation
A professional-grade orchestration skill for generating AI videos, images, and style transfers via the Chenyu Studio API.
BTC Price Monitor
A lightweight integration for tracking real-time Bitcoin market prices and delivering automated Telegram notifications.
sync_wizard
A specialized synchronization tool designed to bridge the gap between Onelap cycling records and Strava after official support ended.
Featured*
