tasknotes

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

http://127.0.0.1:8090/api

List Tasks

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

Create Task

curl -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:

Field	Values
title	Task name (required)
status	open, in-progress, done
priority	none, low, normal, high
projects	["[[Project Name]]"] - array of wikilinks
due	YYYY-MM-DD
scheduled	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS

Update Task

curl -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

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

Get Options

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

Returns available statuses, priorities, and projects.

Example Workflow

# 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"}'