CalDAV

Sync tasks with external apps using CalDAV. Covers supported properties, URLs, and client compatibility.

Warning: The CalDAV integration is in an early alpha stage and has bugs. It works well with some clients while having issues with others. If you encounter issues, please report them

Vikunja supports managing tasks via the caldav VTODO extension.

You can find your CalDAV connection details in your Settings under the CalDAV tab.

CalDAV connection details in settings

URLs#

All URLs are located under the /dav subspace.

URLs are:

  • /principals/<username>/: Returns URLs for project discovery. Use this URL when connecting a new client.
  • /projects/: Used to manage projects
  • /projects/<Project ID>/: Used to manage a single project
  • /projects/<Project ID>/<Task UID>: Used to manage a task on a project

Supported properties#

Vikunja currently supports the following properties:

  • UID
  • SUMMARY
  • DESCRIPTION
  • PRIORITY
  • CATEGORIES
  • COMPLETED
  • CREATED (only Vikunja → Client)
  • DUE (Due date)
  • DURATION
  • DTSTAMP
  • DTSTART
  • LAST-MODIFIED (only Vikunja → Client)
  • RELATED-TO (parent/child relations)
  • RRULE (Recurrence) (only Vikunja → Client)
  • STATUS (only COMPLETED status, used to mark tasks as done)
  • VALARM (Reminders)

Vikunja currently does not support these properties:

  • ATTACH
  • CLASS
  • COMMENT
  • CONTACT
  • GEO
  • LOCATION
  • ORGANIZER (disabled)
  • PERCENT-COMPLETE
  • RECURRENCE-ID
  • RESOURCES
  • SEQUENCE
  • URL

Tested Clients#

Working#

Not working#

On this page