Verify the server can reach Vikunja and read a project.

project_id overrides the configured default, and is REQUIRED when no default is set — the normal case when several projects are used on one machine. There is no project-less health check by design: proving the token works means reading something, and every alternative route (/projects, /tasks/all) would demand a token scope the task tools themselves never need.

Returns {ready: true, ...} when a task READ succeeds, else {ready: false, issues: [...]} with the specific fix (token/URL/project/scope). Run this first if anything seems off.

List tasks in a Vikunja project (open only unless include_done=true).

Uses VIKUNJA_PROJECT_ID/VIKUNJA_PROJECT when project_id is omitted. Sorted open-first, then priority (high first), then id.

Get a single task by its global id, including its description (HTML).

task_id is the id field, NOT the index/identifier shown in the UI. To act on a task the user named by its UI number (e.g. "HL-12"), list the project and match on identifier/index first, then pass that task's id here.

Create a task. priority 0..5; due is yyyy-MM-dd; description is markdown; labels are created if missing then attached. Returns the created task.

Update a task; only the fields you pass change (read-modify-write). Pass due="" to clear the due date, description="" to clear the description. Returns the updated task.

Mark a task done. Returns the updated task.

Reopen a completed task (mark not done). Returns the updated task.