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)