vikunja

What This Skill Does

The Vikunja skill enables OpenClaw to interact directly with your self-hosted Vikunja instance, transforming your AI agent into a comprehensive task management assistant. It provides a robust interface for the Vikunja REST API, allowing the agent to perform create, read, update, and monitor operations on your tasks and projects. By utilizing this skill, you can offload the manual management of to-do lists, reminders, and complex projects to the AI, ensuring that your workflow remains organized without needing to switch contexts between your workspace and your task manager.

Installation

To integrate this skill into your OpenClaw environment, execute the installation command: clawhub install openclaw/skills/skills/nickian/vikunja-tasks. After installation, you must configure your environment variables to allow the agent to authenticate with your instance. Add VIKUNJA_URL and VIKUNJA_TOKEN to your system configuration. You can generate your API token by navigating to Vikunja Settings, then to the API Tokens section, and creating a new token. Ensure the agent has sufficient permissions to access the desired projects.

Use Cases

This skill is perfect for individuals or teams relying on self-hosted task management. Use it to keep track of daily errands, manage large software projects, or ensure critical deadlines are never missed. Because it supports proactive cron jobs, it is particularly useful for morning briefings where the AI summarizes tasks that are due soon or have become overdue. It effectively bridges the gap between raw data in Vikunja and actionable daily planning.

Example Prompts

1. "What tasks do I have due in the next 24 hours across all my projects?"
2. "Create a new project titled 'Home Renovation' and add a task to 'Buy paint' with high priority due on next Friday."
3. "List all tasks in the 'Work' project that have an 'urgent' priority and mark the first one as complete."

Tips & Limitations

When interacting with the agent, remember that project names are case-insensitive, simplifying the command structure. Ensure your environment timezone is correctly configured, as the agent relies on America/Denver standards by default. While the tool is powerful, be aware that it depends on the availability of your self-hosted Vikunja instance; if your network is down, the agent cannot sync data. For advanced users, Vikunja's filter syntax can be passed to refine results further. Keep in mind that tasks are permanent; ensure your API token has appropriate scoped access to avoid accidental deletions or unwanted modifications.