Tasks.org in the browser: a self-hosted CalDAV web UI
caldav-tasks-web is a self-hosted CalDAV web UI: your task lists in a browser, synced with the server your phone uses. Made for Tasks.org on Android.
Anton ShubinUpdated 7 min read
The tool: caldav-tasks-webCode: github.com/spy4x/caldav-tasks-web (opens in a new tab)
TL;DR
- Update: rewritten for the rebuilt app. It has no database and no accounts; one install serves one person.
- caldav-tasks-web opens your Tasks.org lists in a browser, straight from the CalDAV server your phone syncs with. No second account, no second copy.
- The server only relays; the browser edits a task's text in place, so fields the phone stored, reminders included, survive an edit.
- Tested against Radicale 3.5.4 in Chromium, and I run it with Stalwart 0.16. It is one Docker container behind your HTTPS reverse proxy.
Update, 30 October 2026: I rewrote this post for the rebuilt version of caldav-tasks-web. The July post described the first version, which the rewrite replaced; what changed is below.
Tasks.org on Android syncs your tasks to a CalDAV server you control. At a desk, there is no good way to see them: Tasks.org has no web UI. caldav-tasks-web is the self-hosted web UI I built for that gap. It opens the same lists in a browser, on the same CalDAV server, and writes your edits back the way Tasks.org wrote them.
This post is for people who already run a CalDAV server and use Tasks.org. I'll show what the app does, how it keeps the phone's data intact, which servers it is known to work with, and how to run it.
What changed since the first version
Link to section: What changed since the first versionI first wrote this post in July 2026 about the first version. That version kept user accounts and encrypted server passwords in its own SQLite database. It did not work with Stalwart, and it could lose data when you saved a task. So I rewrote it.
The rewrite has no database and no accounts. One install is one owner and one
CalDAV account; a second person runs a second install. It also does what the
first version did not: completing a repeating task moves it to its next date,
and edits made offline are queued. Everything below describes the current code,
at commit
8f13fae.
What you can do in the browser
Link to section: What you can do in the browser- See Today (overdue and due today), Upcoming (the next 14 days), each list, and Search over titles, notes and tags across all lists.
- Add, edit, complete, delete and undo. The quick-add line understands a tag, a
time and a priority:
Order compost #garden 5pm !1. - Use subtasks, tags, priority, due and start dates, notes, and manual order by drag or keyboard. Deleting a task deletes its subtasks too, as Tasks.org does.
- Create, rename, recolour and delete lists while you are online.
- Get reminder notifications through Web Push, for the reminders Tasks.org stores on a task. They are off until you set them up.
- Press
?for the keyboard shortcuts.
The app stores things the way Tasks.org does: a list is a CalDAV calendar, a tag
is a CATEGORIES value, a subtask points to its parent with RELATED-TO,
manual order is X-APPLE-SORT-ORDER, and priority is 1, 5, 9 or 0. Open the
same list on the phone and it looks the same.
Repeating tasks
Link to section: Repeating tasksA task can repeat daily, weekly, monthly or yearly, every N days, weeks, months or years, on chosen weekdays, and end never, on a date or after a number of times.
The editor also asks what the next date counts from: the due date, or the day
you complete the task. Tasks.org has the same choice, but it keeps it in the
phone's own database and writes nothing about it into the task. So the web app
keeps its choice in the task as X-REPEAT-FROM:COMPLETION, which Tasks.org does
not read. Set it in both apps; if they differ, the app you complete the task in
decides the next date.
A repeat rule the app cannot reproduce is never rewritten. The task shows "Complete this one in Tasks.org" instead.
How it keeps the phone's data intact
Link to section: How it keeps the phone's data intactThe first version could lose data when you saved a task. Here is how the current
one avoids it. Tasks.org writes fields the web app doesn't show: its own X-
lines, reminder blocks (VALARM), its PRODID. An app that turns a task into
its own model and writes that model back drops all of them.
So the browser never rebuilds a task. To change one, it reads the task's text as
stored, changes only the properties you edited, and writes the whole text back.
Everything else stays as it was. A browser test against Radicale checks that a
saved edit keeps a reminder and a property the app doesn't know
(e2e/tasks.e2e.ts).
The server in between is a relay. It signs you in, passes CalDAV requests on and serves the app. It never edits a task and never parses one, except to find due reminders when you turn notifications on. Your CalDAV password stays on the server; the browser never sees it.
Because the server sends your CalDAV credentials with every request, it refuses
any address the browser sends that is not a calendar it listed, or a task
directly inside one. This is the check for "directly inside", from
apps/server/caldav/scope.ts:
export function parentCalendar(objectPath: string): string | null {
if (objectPath.endsWith("/")) return null
const cut = objectPath.lastIndexOf("/") + 1
if (/%(2f|5c)/i.test(objectPath.slice(cut))) return null
return objectPath.slice(0, cut)
}
- An address ending in
/is a collection, not a task, so it has no parent calendar. - The task's own name may not hold an encoded slash or backslash (
%2F,%5C): the CalDAV server might decode it into a separator and reach outside the calendar. - Otherwise the calendar is everything up to the last
/, and the relay then checks that it is one of the calendars it listed.
When two devices change the same task, nothing is overwritten silently. Every write carries the task's version marker (its ETag). If the task changed since the browser read it, the app reads the fresh copy and applies your edit to it. If you and the other device changed the same field, it asks you instead.
Offline
Link to section: OfflineThe browser keeps a copy of your lists in IndexedDB and shows it first, then refreshes. Edits made offline wait in a queue and are sent when the network returns. If a queued edit clashes with a change made elsewhere, you choose: Keep mine writes the fields you changed onto the server's copy, Use theirs drops your edit. A service worker lets the app open offline and install as an app.
Which CalDAV servers work
Link to section: Which CalDAV servers workOnly what the repository shows
(docs/compatibility.md):
| Server | Version | Status |
|---|---|---|
| Radicale | 3.5.4 | Tested |
| Stalwart | 0.16 | In my use |
| Nextcloud | - | Untested |
| Baikal | - | Untested |
Radicale is tested: the browser tests run against it, locally and in CI. Stalwart is the server I run it against myself; no automated test talks to it.
Any other server needs CalDAV calendars that hold tasks (VTODO) and accept a
username and password. If you try one, an issue with the server, its version and
what happened helps the next person.
On the client side, the tests use task files in Tasks.org's form, but no test drives the Android app itself. The browser tests run in Chromium only, so Firefox and Safari are untested.
What it doesn't do
Link to section: What it doesn't do- Several users. One install is one owner. It is not a hosted service and has no sign-up.
- Move a task to another list. It refuses that for now.
- Every edge case. An edit can be lost in rare cases: two offline edits made from the same stale copy, or a task deleted on another device while you edit it. That is issue #119.
How to run it
Link to section: How to run itYou need a CalDAV account and a reverse proxy with HTTPS. Sign-in uses a
__Host- cookie, and the service worker and notifications need a secure origin,
so plain http:// works only on localhost.
First make the hash of the password you will sign in with. This step needs Deno 2 and a clone of the repository, because the image does not carry the script:
git clone https://github.com/spy4x/caldav-tasks-web && cd caldav-tasks-web
echo "AUTH_PEPPER=$(openssl rand -base64 32)" > .env
deno task password:hash # type your sign-in password; it prints the hash
Then start the container, with the same AUTH_PEPPER. Keep single quotes around
the hash, because it contains $:
docker run -d --name caldav-tasks-web --restart unless-stopped \
-p 127.0.0.1:8080:8080 \
-e PUBLIC_URL=https://tasks.example.com \
-e CALDAV_URL=https://caldav.example.com \
-e CALDAV_USERNAME='<your CalDAV username>' \
-e CALDAV_PASSWORD='<your CalDAV password>' \
-e OWNER_PASSWORD_HASH='<your password hash>' \
-e AUTH_PEPPER='<the AUTH_PEPPER from .env>' \
-e SESSION_SECRET='<a random string of 32 or more characters>' \
antonshubin/caldav-tasks-web:latest
Both blocks are from the
README.
For a real install, pin a release tag instead of latest; the
tool page shows the current one. The port is
published on 127.0.0.1 only, so put your reverse proxy on the same machine.
GET /health answers {"status":"ok"}. Reminders, the proxy setup and backups
are in
docs/self-hosting.md.
Try it
Link to section: Try itThe caldav-tasks-web page has a one-minute demo with made-up tasks: quick add, a subtask moved by keyboard, a weekly repeat, complete and undo. If you also want an AI assistant to read and add tasks on the same server, caldav-mcp is my MCP server for CalDAV events and tasks.
Which CalDAV server do you run Tasks.org against? If it isn't Radicale or Stalwart, try it and tell me in an issue whether it works.
Anton Shubin
Senior Full-Stack Engineer & Tech Lead
I build greenfield SaaS on a modern, lightweight stack, alone or with a team of senior developers from my own pool, and I cover full-stack, DevOps and architecture.
Get the next post by email
New posts on decisions for founders, developer craft, AI and MCP, self-hosting, and my own mistakes, about once a week at most, and only when there is one. Unsubscribe with one click.
Questions, or a different result? Reply by email: hi@antonshubin.com. It comes straight to me.
