tasknotes

TaskNotes Skill

Manage Obsidian tasks via the TaskNotes plugin HTTP API.

Requirements

1. TaskNotes plugin installed in Obsidian
2. Enable HTTP API in TaskNotes settings:
   • Open Obsidian Settings → TaskNotes
   • Enable "HTTP API" toggle
   • Set API port (default: 8080)
   • API token: leave empty for no auth, or set a token for security
3. Environment variables in .env file at vault root (if using auth):

   TASKNOTES_API_PORT=8080
   TASKNOTES_API_KEY=your_token_here
   

   If TaskNotes has no auth token set, you don't need a .env file.

CLI Commands

# List all tasks
uv run scripts/tasks.py list

# List by status (use your configured status values)
uv run scripts/tasks.py list --status "in-progress"

# List by project
uv run scripts/tasks.py list --project "My Project"

# Create task
uv run scripts/tasks.py create "Task title" --project "My Project" --priority high

# Create task with scheduled time
uv run scripts/tasks.py create "Meeting prep" --scheduled "2025-01-15T14:00:00"

# Update task status
uv run scripts/tasks.py update "Tasks/task-file.md" --status done

# Add/update task description
uv run scripts/tasks.py update "Tasks/task-file.md" --details "Additional context here."

# Delete task
uv run scripts/tasks.py delete "Tasks/task-file.md"

# Get available options (statuses, priorities, projects)
uv run scripts/tasks.py options --table

# Human-readable output (add --table)
uv run scripts/tasks.py list --table

Task Properties

Status and Priority values: Configured in your TaskNotes plugin settings. Run options command to see available values:

uv run scripts/tasks.py options --table

Other fields:

• projects - Array of project links, e.g. ["[[Project Name]]"]
• contexts - Array like ["office", "energy-high"]
• due - Due date (YYYY-MM-DD)
• scheduled - Scheduled date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)
• timeEstimate - Minutes (number)
• tags - Array of tags
• details - Task description (writes to markdown body, not frontmatter)

API Reference

Base URL: http://localhost:8080/api

Method	Endpoint	Description
GET	/tasks	List tasks (supports filters)
POST	/tasks	Create task
GET	/tasks/{id}	Get single task
PUT	/tasks/{id}	Update task
DELETE	/tasks/{id}	Delete task
GET	/filter-options	Available statuses, priorities, projects

Query Parameters for GET /tasks

• status - Filter by status
• project - Filter by project name
• priority - Filter by priority
• tag - Filter by tag
• overdue - true/false
• sort - Sort field
• limit - Max results
• offset - Pagination offset

When to Use

• "create a task for X" → create task
• "show my tasks" → list all tasks
• "show in-progress tasks" → list --status in-progress
• "mark X as done" → update task status to done
• "what should I work on" → list tasks by status

Example Workflow

# Morning: Check what to work on
uv run scripts/tasks.py list --status in-progress --table
uv run scripts/tasks.py list --limit 5 --table

# Create task linked to project
uv run scripts/tasks.py create "Finish landing page" \
  --project "Website Redesign" \
  --priority high

# Complete a task
uv run scripts/tasks.py update "Tasks/finish-landing-page.md" --status done