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