---

name: tasknotes description: Create, update, delete, and list tasks via HTTP API. USE WHEN user wants to create tasks, mark done, update status, or manage tasks.

TaskNotes Skill

CRUD operations on tasks via TaskNotes plugin HTTP API.

API Endpoint

Copyhttp://127.0.0.1:8090/api

List Tasks

Copycurl -s "http://127.0.0.1:8090/api/tasks"
curl -s "http://127.0.0.1:8090/api/tasks?status=in-progress"

Create Task

Copycurl -X POST "http://127.0.0.1:8090/api/tasks" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Task title",
    "status": "open",
    "priority": "high",
    "projects": ["[[Project Name]]"],
    "due": "2026-01-15",
    "scheduled": "2026-01-10"
  }'

Fields:

Update Task

Copycurl -X PUT "http://127.0.0.1:8090/api/tasks/Tasks%2Fmy-task.md" \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}'

Note: Path must be URL-encoded (/ → %2F, space → %20)

Delete Task

Copycurl -X DELETE "http://127.0.0.1:8090/api/tasks/Tasks%2Fmy-task.md"

Get Options

Copycurl -s "http://127.0.0.1:8090/api/options"

Returns available statuses, priorities, and projects.

Example Workflow

Copy# Create
curl -X POST "http://127.0.0.1:8090/api/tasks" \
  -H "Content-Type: application/json" \
  -d '{"title": "Review proposal", "status": "open", "projects": ["[[Website Redesign]]"]}'

# Start working
curl -X PUT "http://127.0.0.1:8090/api/tasks/Tasks%2FReview%20proposal.md" \
  -H "Content-Type: application/json" \
  -d '{"status": "in-progress"}'

# Complete
curl -X PUT "http://127.0.0.1:8090/api/tasks/Tasks%2FReview%20proposal.md" \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}'