How do I install the Tasknotes skill?

Run npx skillmds@latest add dvcrn/tasknotes in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tasknotes safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tasknotes?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tasknotes free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tasknotes?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tasknotes by dvcrn — Agent Skill

Name: Tasknotes
Rating: 4.5 (4 reviews)
Author: dvcrn

File contents

TaskNotes Skill

Manage Obsidian tasks via the TaskNotes plugin HTTP API.

Requirements

TaskNotes plugin installed in Obsidian
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
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

---name: tasknotesdescription: Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.---# TaskNotes SkillManage Obsidian tasks via the TaskNotes plugin HTTP API.## Requirements1. **TaskNotes plugin** installed in Obsidian2. **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 security3. **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```bash# List all tasksuv run scripts/tasks.py list# List by status (use your configured status values)uv run scripts/tasks.py list --status "in-progress"# List by projectuv run scripts/tasks.py list --project "My Project"# Create taskuv run scripts/tasks.py create "Task title" --project "My Project" --priority high# Create task with scheduled timeuv run scripts/tasks.py create "Meeting prep" --scheduled "2025-01-15T14:00:00"# Update task statusuv run scripts/tasks.py update "Tasks/task-file.md" --status done# Add/update task descriptionuv run scripts/tasks.py update "Tasks/task-file.md" --details "Additional context here."# Delete taskuv 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:```bashuv 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 ReferenceBase 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```bash# Morning: Check what to work onuv run scripts/tasks.py list --status in-progress --tableuv run scripts/tasks.py list --limit 5 --table# Create task linked to projectuv run scripts/tasks.py create "Finish landing page" \ --project "Website Redesign" \ --priority high# Complete a taskuv run scripts/tasks.py update "Tasks/finish-landing-page.md" --status done```

Frequently asked questions

Tasknotes