✓ Verified 💻 Development ✓ Enhanced Data

Vikunja Tasks

Manage tasks and projects on a self-hosted Vikunja instance.

Rating: 3.8 (61 reviews)
Downloads: 1,290 downloads
Version: 1.0.0

Overview

Manage tasks and projects on a self-hosted Vikunja instance.

Complete Documentation

View Source →

Vikunja Task Manager

Manage tasks and projects on a self-hosted Vikunja instance via REST API.

Setup

Set these environment variables:

bash

export VIKUNJA_URL="https://your-vikunja-instance.com"
export VIKUNJA_TOKEN="your-api-token"

Get your API token: Vikunja → Settings → API Tokens → Create token.

Commands

List tasks

bash

{baseDir}/scripts/vikunja.sh tasks --count 10
{baseDir}/scripts/vikunja.sh tasks --project "Shopping" --count 5
{baseDir}/scripts/vikunja.sh tasks --search "groceries"
{baseDir}/scripts/vikunja.sh tasks --sort priority --order desc

Overdue tasks

bash

{baseDir}/scripts/vikunja.sh overdue

Tasks due soon (next N hours)

bash

{baseDir}/scripts/vikunja.sh due --hours 24
{baseDir}/scripts/vikunja.sh due --hours 48

Create a task

bash

{baseDir}/scripts/vikunja.sh create-task --project "Tasks" --title "Buy milk" --due "2026-02-01" --priority 3

Priority: 1 (low) to 5 (urgent). Due date format: YYYY-MM-DD.

Complete a task

bash

{baseDir}/scripts/vikunja.sh complete --id 123

Get task details

bash

{baseDir}/scripts/vikunja.sh task --id 123

List projects

bash

{baseDir}/scripts/vikunja.sh projects

Create a project

bash

{baseDir}/scripts/vikunja.sh create-project --title "New Project" --description "Optional description"

Get notifications

bash

{baseDir}/scripts/vikunja.sh notifications

Due Date Monitoring

To get proactive notifications about due/overdue tasks, set up a cron job:

bash

clawdbot cron add \
  --name "Task due check" \
  --cron "0 9,14 * * *" \
  --tz "America/Denver" \
  --session isolated \
  --message "Check Vikunja for overdue and upcoming tasks (next 24 hours). If any are found, notify me with the list." \
  --deliver \
  --channel telegram

Notes

Project names in --project are case-insensitive
Filter expressions follow Vikunja filter syntax (see https://vikunja.io/docs/filters)
All times are handled in America/Denver timezone

Installation

Terminal bash


openclaw install vikunja-tasks

Copied!

💻Code Examples

export VIKUNJA_TOKEN="your-api-token"

export-vikunjatokenyour-api-token.txt

Get your API token: Vikunja → Settings → API Tokens → Create token.

## Commands

### List tasks

{baseDir}/scripts/vikunja.sh create-task --project "Tasks" --title "Buy milk" --due "2026-02-01" --priority 3

basedirscriptsvikunjash-create-task---project-tasks---title-buy-milk---due-2026-02-01---priority-3.txt

Priority: 1 (low) to 5 (urgent). Due date format: YYYY-MM-DD.

### Complete a task

{baseDir}/scripts/vikunja.sh notifications

basedirscriptsvikunjash-notifications.txt

## Due Date Monitoring

To get proactive notifications about due/overdue tasks, set up a cron job:

example.sh

{baseDir}/scripts/vikunja.sh tasks --count 10
{baseDir}/scripts/vikunja.sh tasks --project "Shopping" --count 5
{baseDir}/scripts/vikunja.sh tasks --search "groceries"
{baseDir}/scripts/vikunja.sh tasks --sort priority --order desc

example.sh

clawdbot cron add \
  --name "Task due check" \
  --cron "0 9,14 * * *" \
  --tz "America/Denver" \
  --session isolated \
  --message "Check Vikunja for overdue and upcoming tasks (next 24 hours). If any are found, notify me with the list." \
  --deliver \
  --channel telegram