TaskNotes

https://tasknotes.dev
Admin
TaskNotes is a task and note management plugin for Obsidian that treats each task as its own...
Tokens:79,608
Snippets:1,202
Trust Score:4.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example Kanban View Configuration

Source: https://tasknotes.dev/views/kanban-view

A typical Kanban view configuration in a .base file. This setup defines columns based on task status, swimlanes based on priority, and includes various display and operational settings.

```yaml
---
type: query
source: TaskNotes
view: TaskNotes Kanban
views:
  - name: TaskNotes Kanban
    type: tasknotesKanban
    groupBy:
      property: task.status
    config:
      swimLane: task.priority
      swimLaneOrder: '{"task.priority":["high","normal","low"]}'
      columnWidth: 300
      hideEmptyColumns: true
      pinnedColumns: to-do, in-progress, done
      wipLimits: '{"in-progress":5}'
---

```

--------------------------------

### Install mdbase-tasknotes CLI

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Install the mdbase-tasknotes CLI globally using npm.

```bash
npm install -g mdbase-tasknotes
```

--------------------------------

### Install i18n-state-manager

Source: https://tasknotes.dev/development/i18n-state-manager

Install the i18n-state-manager package as a development dependency.

```bash
npm install -D i18n-state-manager
```

--------------------------------

### Minimal Task File Example

Source: https://tasknotes.dev/spec/00-overview

A basic example of a task file in markdown format, including YAML frontmatter with essential task properties and a brief description.

```markdown
---
title: Buy groceries
status: open
priority: normal
due: 2026-02-21
tags: [task]
dateCreated: 2026-02-20T11:15:00Z
dateModified: 2026-02-20T11:15:00Z
---

Buy fruit and cleaning supplies.
copy

```

--------------------------------

### Complete Configuration Example

Source: https://tasknotes.dev/spec/09-configuration

A comprehensive example of a TaskNotes configuration file using the `yaml_file` provider. It includes settings for runtime timezone, task mapping, detection, defaults, status values, validation, dependencies, links, templating, reminders, time tracking, and compatibility.

```yaml
spec_version: 0.1.0-draft
runtime_timezone: America/Los_Angeles

mapping:
  title: title
  status: status
  priority: priority
  due: due
  scheduled: scheduled
  completed_date: completedDate
  date_created: dateCreated
  date_modified: dateModified
  recurrence: recurrence
  recurrence_anchor: recurrenceAnchor
  complete_instances: completeInstances
  skipped_instances: skippedInstances
  time_entries: timeEntries
  blocked_by: blockedBy
  reminders: reminders

task_detection:
  method: tag
  tag: task
  default_folder: TaskNotes/Tasks

defaults:
  status: open
  priority: normal
  recurrence_anchor: scheduled
  reminders:
    - id: due_minus_1d
      type: relative
      relatedTo: due
      offset: -P1D

status:
  values: [open, in-progress, done, cancelled]
  default: open
  completed_values: [done, cancelled]

validation:
  mode: strict
  reject_unknown_fields: false

dependencies:
  default_reltype: FINISHTOSTART
  treat_missing_target_as_blocked: true
  enforce_unique_uid: true
  unresolved_target_severity: warning
  require_resolved_uid_on_write: false

links:
  extensions: [".md"]
  unresolved_default_severity: warning
  update_references_on_rename: true

title:
  storage: filename

templating:
  enabled: false
  failure_mode: warning_fallback
  unknown_variable_policy: preserve

reminders:
  date_only_anchor_time: "00:00"
  apply_defaults_when_explicit: false

time_tracking:
  auto_stop_on_complete: true
  auto_stop_notification: false

compatibility:
  read_aliases: true
  legacy_duration_field: true

```

--------------------------------

### Early Start Before DTSTART

Source: https://tasknotes.dev/features/recurring-tasks

Demonstrates scheduling a recurring task to occur before its defined DTSTART. This allows for initial setup or early instances outside the regular pattern.

```yaml
recurrence: "DTSTART:20250810T090000Z;FREQ=WEEKLY;BYDAY=MO"
scheduled: "2025-08-07T14:00"
copy
```

--------------------------------

### Complete Task Example

Source: https://tasknotes.dev/settings/property-types-reference

A comprehensive example of a task file including title, status, priority, dates, tags, projects, time estimates, timestamps, time entries, dependencies, and reminders.

```yaml
---
title: "Complete quarterly report"
status: "in-progress"
priority: "high"
due: "2025-01-31"
scheduled: "2025-01-25"
tags:
  - work
  - reports
contexts:
  - "@office"
projects:
  - "[[Q1 Planning]]"
timeEstimate: 240
dateCreated: "2025-01-01T08:00:00Z"
dateModified: "2025-01-20T14:30:00Z"
timeEntries:
  - startTime: "2025-01-20T10:00:00Z"
    endTime: "2025-01-20T11:30:00Z"
blockedBy:
  - uid: "tasks/gather-data.md"
    reltype: "FINISHTOSTART"
reminders:
  - id: "rem_1"
    type: "relative"
    relatedTo: "due"
    offset: "-P1D"
    description: "Due tomorrow"
---

```

--------------------------------

### Example Task Update

Source: https://tasknotes.dev/spec/05-operations

Demonstrates a patch update operation changing the priority of a task. This example shows the state before and after the operation.

```yaml
title: Weekly review
scheduled: 2026-02-20
priority: normal
customClient: ACME
copy
```

```yaml
title: Weekly review
scheduled: 2026-02-20
priority: high
customClient: ACME
copy
```

--------------------------------

### Launch Interactive Mode

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Starts the interactive REPL for live NLP preview of task descriptions.

```bash
mtn interactive
# or
mtn i
```

--------------------------------

### Compatibility Statement Example

Source: https://tasknotes.dev/spec/08-compatibility-and-migrations

An example of a compatibility statement indicating enabled legacy modes, the planned removal version, and the command to initiate migration.

```yaml
Compatibility mode: legacy-aliases=true, legacy-timeentry-duration=true
Planned removal: v2.0.0
Migration command: tasknotes migrate --normalize-frontmatter
copy
```

--------------------------------

### Daily Recurrence Pattern Example

Source: https://tasknotes.dev/features/recurring-tasks

Example of a daily recurrence pattern starting at a specific time on a given date.

```text
DTSTART:20250804T090000Z;FREQ=DAILY
→ Daily at 9:00 AM, starting August 4, 2025
```

--------------------------------

### Start Time Tracking with Description

Source: https://tasknotes.dev/HTTP_API

Starts a new time entry for a task and includes a description for the entry. The description is a string value.

```json
{
  "description": "Implementation"
}
```

--------------------------------

### Start Pomodoro Session

Source: https://tasknotes.dev/HTTP_API

Starts a Pomodoro session. Optionally specify a task and duration.

```APIDOC
## POST /api/pomodoro/start

### Description
Starts a session. Optional request fields: `taskId` (URL path of task), `duration` (number).

### Method
POST

### Endpoint
/api/pomodoro/start
```

--------------------------------

### Example Task Record with Frontmatter

Source: https://tasknotes.dev/spec/02-model-and-mapping

Demonstrates a complete task record including frontmatter with various fields like ID, title, status, recurrence, reminders, and dates. This example shows how different data types and structures are represented.

```yaml
---
id: task-2026-01-10-weekly-review
title: Weekly review
status: open
priority: high
scheduled: 2026-02-20
recurrence: FREQ=WEEKLY;BYDAY=FR
recurrence_anchor: scheduled
complete_instances: [2026-02-13]
skipped_instances: []
blockedBy:
  - uid: "[[prepare-metrics]]"
    reltype: FINISHTOSTART
    gap: P1D
reminders:
  - id: rem_day_before
    type: relative
    relatedTo: due
    offset: -P1D
  - id: rem_start
    type: absolute
    absoluteTime: 2026-02-20T09:00:00Z
dateCreated: 2026-01-10T09:30:00Z
dateModified: 2026-02-20T08:02:11Z
---

Review completed work and plan next week.
copy
```

--------------------------------

### Datetime Instant Equality Example

Source: https://tasknotes.dev/spec/03-temporal-semantics

Demonstrates how different timezone offsets normalize to the same UTC instant.

```text
2026-02-20T08:00:00-05:00
```

--------------------------------

### Start Time Tracking with Description

Source: https://tasknotes.dev/HTTP_API

Starts time tracking for a task and adds a description to the new active entry.

```APIDOC
## POST /api/tasks/:id/time/start-with-description

### Description
Starts time tracking and writes `description` on the new active entry.

### Method
POST

### Endpoint
/api/tasks/:id/time/start-with-description

### Parameters
#### Request Body
- **description** (string) - Required - Description for the time entry
```

--------------------------------

### Example API Request with Authentication

Source: https://tasknotes.dev/HTTP_API

This example shows how to make an API request to the health endpoint, including the Authorization header with a bearer token.

```shell
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:8080/api/health
copy

```

--------------------------------

### Start Time Tracking

Source: https://tasknotes.dev/HTTP_API

Starts a new active time entry for a specific task.

```APIDOC
## POST /api/tasks/:id/time/start

### Description
Starts a new active time entry for that task.

### Method
POST

### Endpoint
/api/tasks/:id/time/start
```

--------------------------------

### Example Conformance Claim

Source: https://tasknotes.dev/spec/07-conformance

This is an example of a conformance claim format that an implementation must provide. It includes details about the implementation, spec version, claimed profiles, validation modes, and configuration.

```text
Implementation: example-task-cli v1.4.0
Spec: tasknotes-spec 0.1.0-draft
Profiles: core-lite, recurrence, templating
Validation modes: strict, permissive
Known deviations: none
Compatibility mode: disabled
Configuration providers: tasknotes_plugin_data_json > built_in_defaults
Configuration fallback: none
```

--------------------------------

### User Field Frontmatter Example

Source: https://tasknotes.dev/features/user-fields

Example of how user field data is stored in the frontmatter of a task note.

```yaml
---
my_field: value
---
copy
```

--------------------------------

### Run Local Test Server

Source: https://tasknotes.dev/webhooks

Command to start the local webhook test server. An optional custom port can be specified.

```bash
node test-webhook.js
```

```bash
node test-webhook.js 8080
```

--------------------------------

### Example Dependency Entry

Source: https://tasknotes.dev/spec/10-dependencies-and-reminders

An example of a task dependency entry, specifying a blocking task, relationship type, and a time gap.

```yaml
blockedBy:
  - uid: "[[prepare-metrics]]"
    reltype: FINISHTOSTART
    gap: PT4H
```

--------------------------------

### v3 Filter Example

Source: https://tasknotes.dev/migration-v3-to-v4

Example of a custom filter configuration in TaskNotes v3. This syntax is replaced in v4.

```text
status: in-progress
priority: high
copy
```

--------------------------------

### Start Pomodoro Session

Source: https://tasknotes.dev/HTTP_API

Starts a pomodoro session. Optionally accepts a taskId and duration.

```json
{
  "taskId": "URL path of task",
  "duration": "number"
}
```

--------------------------------

### Dependency with Wikilink

Source: https://tasknotes.dev/spec/11-links

Example of defining dependencies and projects using default wikilink format in a task's frontmatter.

```yaml
---
title: Implement API
status: open
tags: [task]
blockedBy:
  - uid: "[[design-api]]"
    reltype: FINISHTOSTART
  - uid: "[[projects/infra/setup-server]]"
    reltype: FINISHTOSTART
    gap: P1D
projects:
  - "[[projects/alpha]]"
dateCreated: 2026-02-20T10:00:00Z
dateModified: 2026-02-20T10:00:00Z
---
```

--------------------------------

### Completed Instances Tracking

Source: https://tasknotes.dev/features/recurring-tasks

Example showing the format for storing a list of completed instances for a recurring task.

```yaml
complete_instances: ["2025-08-04", "2025-08-06", "2025-08-08"]
```

--------------------------------

### Normalized Datetime Instant Example

Source: https://tasknotes.dev/spec/03-temporal-semantics

Shows the canonical UTC representation after normalization from a timezone-shifted input.

```text
2026-02-20T13:00:00Z
```

--------------------------------

### Start Task Timer

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Begin tracking time spent on a task. An optional description can be provided for the time entry.

```bash
mtn timer start "Write report"
mtn timer start "Write report" -d "Drafting introduction"
```

--------------------------------

### Body Template Example

Source: https://tasknotes.dev/features/template-variables

Example of a body template using various variables for note creation, including date, priority, status, title, details, parent note, tags, and a 'copy' placeholder.

```markdown
---
created: {{date}}
priority: {{priority}}
status: {{status}}
---

# {{title}}

{{details}}

Created from: {{parentNote}}
Tags: {{hashtags}}
copy
```

--------------------------------

### JSON Transform File Example

Source: https://tasknotes.dev/webhooks

An example of a JSON transform file used to customize webhook payload content. It maps event types to specific output structures.

```json
{
  "task.completed": {
    "text": "Task completed: ${data.task.title}",
    "vault": "${vault.name}"
  },
  "default": {
    "text": "TaskNotes event: ${event}"
  }
}
```

--------------------------------

### Create Task - Input Intent

Source: https://tasknotes.dev/spec/05-operations

Example input for creating a task with a title and copy directive. Assumes default status and priority.

```markdown
title: "Pay electricity bill"
copy
```

--------------------------------

### List Property Examples: Contexts

Source: https://tasknotes.dev/settings/property-types-reference

Use the 'contexts' property to assign context labels to a task. It requires an array of strings.

```yaml
contexts: ["office", "computer"]
```

```yaml
contexts:
  - "office"
  - "computer"
```

--------------------------------

### Get Configuration Value

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Retrieves the value of a specific configuration setting.

```bash
mtn config --get collectionPath                 # Get a setting
```

--------------------------------

### Dependency with Markdown Links

Source: https://tasknotes.dev/spec/11-links

Example of defining dependencies using markdown link format when `links.use_markdown_format` is set to true.

```yaml
---
title: Implement API
status: open
tags: [task]
blockedBy:
  - uid: "[design-api](TaskNotes/Tasks/design-api.md)"
    reltype: FINISHTOSTART
---
```

--------------------------------

### Link Parsing Examples

Source: https://tasknotes.dev/spec/11-links

Illustrates the structured representation of parsed links, showing target, alias, anchor, format, and relativity.

```markdown
Input | target | alias | anchor | format | is_relative
---|---|---|---|---|---
`[[task-001]]` | `task-001` | null | null | wikilink | false
`[[task-001|My Task]]` | `task-001` | `My Task` | null | wikilink | false
`[[docs/api#auth]]` | `docs/api` | null | `auth` | wikilink | false
`[[./sibling]]` | `./sibling` | null | null | wikilink | true
`[Link](file.md)` | `file.md` | `Link` | null | markdown | false
`./other.md` | `./other.md` | null | null | path | true
```

--------------------------------

### Create Task - Persisted Frontmatter

Source: https://tasknotes.dev/spec/05-operations

Example of how the task might be persisted in frontmatter after creation, including default values and generated timestamps.

```yaml
title: Pay electricity bill
status: open
priority: normal
dateCreated: 2026-02-20T14:00:00Z
dateModified: 2026-02-20T14:00:00Z
copy
```

--------------------------------

### Completed Instances Example

Source: https://tasknotes.dev/settings/property-types-reference

Lists the dates when specific instances of a recurring task were completed.

```yaml
complete_instances:
  - "2025-01-08"
  - "2025-01-15"
```

--------------------------------

### List Configuration Settings

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Shows all current configuration settings.

```bash
mtn config --list                              # Show all settings
```

--------------------------------

### Recurrence Rule with DTSTART

Source: https://tasknotes.dev/spec/04-recurrence

An example of a recurrence rule that includes an explicit start date (DTSTART). This is used when a specific start date is required for the recurrence.

```text
DTSTART:20260220;FREQ=WEEKLY;BYDAY=FR
```

--------------------------------

### Example: Local-day overdue evaluation

Source: https://tasknotes.dev/spec/03-temporal-semantics

Demonstrates overdue evaluation for tasks based on local date and timezone. Task A is overdue, while Task B is not overdue at the start of its due day.

```text
due: 2026-02-19
status: open
copy
```

```text
due: 2026-02-20
status: open
copy
```

--------------------------------

### Initial State for Complete then Skip Example

Source: https://tasknotes.dev/spec/04-recurrence

Shows the initial state of recurrence and instance lists before performing a complete then skip operation on the same day.

```yaml
recurrence: FREQ=DAILY
completeInstances: [2026-02-20]
skippedInstances: []
copy
```

--------------------------------

### Example Task File

Source: https://tasknotes.dev/spec/00-overview

Demonstrates the structure and fields of a typical task file, including title, status, priority, due date, tags, and timestamps.

```yaml
---
title: Buy groceries
status: open
priority: normal
due: 2026-02-21
tags: [task, errands]
contexts: ["town"]
dateCreated: 2026-02-20T11:15:00Z
dateModified: 2026-02-20T11:15:00Z
---

Buy fruit and cleaning supplies.

```

--------------------------------

### List Projects

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Lists all projects. Use the --stats flag to include completion percentages.

```bash
# List all projects
mtn projects list
mtn projects list --stats    # With completion percentages
```

--------------------------------

### Conditional Folder Structure Example

Source: https://tasknotes.dev/settings/task-defaults

Demonstrates creating conditional folder structures using template variables. Missing variables result in empty path segments.

```text
Tasks/{{project}}/{{context}}/{{year}}
```

--------------------------------

### Invalid Date Example

Source: https://tasknotes.dev/spec/03-temporal-semantics

An example of an invalid date format that parsers must reject.

```text
2026-02-30
```

--------------------------------

### Valid Date Example

Source: https://tasknotes.dev/spec/03-temporal-semantics

An example of a valid date format that parsers must accept.

```text
2026-02-28
```

--------------------------------

### Idempotent Complete Operation Example

Source: https://tasknotes.dev/spec/04-recurrence

Demonstrates the initial state for an idempotent complete operation. Completing an already completed instance should not change the persisted lists.

```yaml
completeInstances: [2026-02-20]
skippedInstances: []
copy
```

--------------------------------

### Monthly Recurrence by Day of Month Example

Source: https://tasknotes.dev/features/recurring-tasks

Example of a monthly recurrence pattern set to occur on a specific day of the month.

```text
DTSTART:20250815;FREQ=MONTHLY;BYMONTHDAY=15
→ 15th of each month (all-day), starting August 15, 2025
```

--------------------------------

### List Property Examples: Projects

Source: https://tasknotes.dev/settings/property-types-reference

The 'projects' property links tasks to specific projects, typically using wiki-links. It must be an array of strings.

```yaml
projects: ["[[Website Redesign]]", "[[Q1 Planning]]"]
```

```yaml
projects:
  - "[[Website Redesign]]"
  - "[[Q1 Planning]]"
```

--------------------------------

### Weekly Recurrence Pattern Example

Source: https://tasknotes.dev/features/recurring-tasks

Example of a weekly recurrence pattern occurring on specific days of the week at a set time.

```text
DTSTART:20250804T140000Z;FREQ=WEEKLY;BYDAY=MO,WE,FR
→ Monday, Wednesday, Friday at 2:00 PM, starting August 4, 2025
```

--------------------------------

### Example Unresolved Dependency Entry

Source: https://tasknotes.dev/spec/10-dependencies-and-reminders

An example of an unresolved dependency where the target task does not exist. This demonstrates how to represent a dependency on a non-existent task.

```yaml
blockedBy:
  - uid: "[[non-existent-task]]"
    reltype: FINISHTOSTART
```

--------------------------------

### Monthly Recurrence by Last Day of Month Example

Source: https://tasknotes.dev/features/recurring-tasks

Example of a monthly recurrence pattern set to occur on the last day of the month.

```text
DTSTART:20250831;FREQ=MONTHLY;BYMONTHDAY=-1
→ Last day of each month (all-day), starting August 31, 2025
```

--------------------------------

### Worked Example with Recurrence Anchor Completion

Source: https://tasknotes.dev/spec/04-recurrence

Shows a detailed state for a task with recurrence anchor set to completion, including DTSTART, completed instances, and skipped instances. This state is used to demonstrate conforming recalculation.

```yaml
recurrence: DTSTART:20260220;FREQ=DAILY
recurrence_anchor: completion
complete_instances: [2026-02-20, 2026-02-21]
skipped_instances: [2026-02-23]
copy
```

--------------------------------

### Monthly Recurrence by Last Specific Day Example

Source: https://tasknotes.dev/features/recurring-tasks

Example of a monthly recurrence pattern set to occur on the last specific weekday of the month.

```text
DTSTART:20250801T100000Z;FREQ=MONTHLY;BYDAY=-1FR
→ Last Friday of each month at 10:00 AM, starting August 1, 2025
```

--------------------------------

### Example Mapping Configuration

Source: https://tasknotes.dev/spec/02-model-and-mapping

Illustrates how to map canonical field names to their alias equivalents. This configuration is used to define the effective mapping for task data.

```yaml
mapping:
  id: id
  title: title
  status: status
  date_created: dateCreated
  date_modified: dateModified
  completed_date: completedDate
  recurrence: recurrence
  recurrence_anchor: recurrence_anchor
  complete_instances: complete_instances
  skipped_instances: skipped_instances
  time_estimate: timeEstimate
  time_entries: timeEntries
  blocked_by: blockedBy
  reminders: reminders
copy
```

--------------------------------

### Show Task Detail by Title or Path

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Display the full details of a specific task, referenced either by its title or its file path.

```bash
mtn show "Buy groceries"
mtn show tasks/Buy\ groceries.md
```

--------------------------------

### POST /api/nlp/parse Example Response

Source: https://tasknotes.dev/nlp-api

Example response structure for the /api/nlp/parse endpoint, showing both 'parsed' direct parser output and 'taskData' normalized task payload.

```json
{
  "success": true,
  "data": {
    "parsed": {
      "title": "Review PR",
      "tags": ["123"],
      "contexts": ["work"],
      "projects": [],
      "priority": "high",
      "status": null,
      "dueDate": "2026-02-22",
      "scheduledDate": null,
      "dueTime": null,
      "scheduledTime": null,
      "recurrence": null,
      "estimate": null,
      "isCompleted": false
    },
    "taskData": {
      "title": "Review PR",
      "priority": "high",
      "status": "open",
      "tags": ["123"],
      "contexts": ["work"],
      "due": "2026-02-22",
      "dateCreated": "2026-02-22T09:00:00.000Z",
      "dateModified": "2026-02-22T09:00:00.000Z"
    }
  }
}
copy
```

--------------------------------

### List All Open Tasks

Source: https://tasknotes.dev/mdbase-tasknotes-cli

List all currently open tasks, ordered by their due date.

```bash
mtn list
```

--------------------------------

### Example Templater Use for NLP Parsing

Source: https://tasknotes.dev/nlp-api

Example of using Templater within TaskNotes to prompt the user for task text, parse it using the NLP API, and display the parsed title.

```ejs
<%
const tasknotes = app.plugins.plugins.tasknotes;
const text = await tp.system.prompt("Task");
const parsed = tasknotes.api.parseNaturalLanguage(text);
Tp.user.executeTemplate("your_template_name", { parsed });
%>
copy
```

--------------------------------

### Create Webhook via API

Source: https://tasknotes.dev/webhooks

Example using curl to create a new webhook subscription. Specifies the URL, events to subscribe to, and a transform file.

```bash
curl -X POST http://localhost:8080/api/webhooks \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/tasknotes",
    "events": ["task.completed", "task.created"],
    "transformFile": "TaskNotes/webhooks/slack.json"
  }'
```

--------------------------------

### Alias Normalization Migration Example

Source: https://tasknotes.dev/spec/08-compatibility-and-migrations

Demonstrates the transformation of a data structure before and after alias normalization, highlighting the precedence of canonical keys and the preservation of unrelated fields. It also indicates a warning for ignored alias conflicts.

```yaml
recurrenceAnchor: scheduled
recurrence_anchor: completion
copy
```

```yaml
recurrenceAnchor: scheduled
copy
```

--------------------------------

### Task Filter Example

Source: https://tasknotes.dev/views/default-base-templates

Filters tasks that have the tag 'task'.

```yaml
filters:
  and:
    - file.hasTag("task")
```

--------------------------------

### Create Task with POST /api/nlp/create using cURL

Source: https://tasknotes.dev/nlp-api

Example of using cURL to call the /api/nlp/create endpoint to parse text and create a task in one call. Returns HTTP 201 on success.

```bash
curl -X POST http://localhost:8080/api/nlp/create \
  -H "Content-Type: application/json" \
  -d '{"text":"Call mom due friday 2pm #personal"}'
copy
```

--------------------------------

### Get Pomodoro Stats

Source: https://tasknotes.dev/HTTP_API

Returns Pomodoro statistics for today or a specified date.

```APIDOC
## GET /api/pomodoro/stats

### Description
Returns stats for today or provided date. Query params: `date` (`YYYY-MM-DD`).

### Method
GET

### Endpoint
/api/pomodoro/stats

### Parameters
#### Query Parameters
- **date** (string) - Optional - Date in `YYYY-MM-DD` format
```

--------------------------------

### Get Filter Options

Source: https://tasknotes.dev/HTTP_API

Returns filter options suitable for UI builders.

```APIDOC
## GET /api/filter-options

### Description
Returns filter options for UI builders.

### Method
GET

### Endpoint
/api/filter-options
```

--------------------------------

### Skipped Instances Example

Source: https://tasknotes.dev/settings/property-types-reference

Lists the dates when specific instances of a recurring task were skipped.

```yaml
skipped_instances:
  - "2025-01-22"
```

--------------------------------

### Configurable Project Suggestion Cards

Source: https://tasknotes.dev/features/task-management

Project suggestions can be enhanced with multi-row cards and smarter search, configurable via Settings. This example shows how to display the title and aliases with labels.

```text
{title|n(Title)}
```

```text
🔖 {aliases|n(Aliases)}
```

```text
{file.path|n(Path)|s}
```

--------------------------------

### Recurrence Anchor Example

Source: https://tasknotes.dev/settings/property-types-reference

Specifies that the next recurrence of a task should be calculated from its scheduled date.

```yaml
recurrence_anchor: "scheduled"
```

--------------------------------

### Combining Static Paths with Template Variables

Source: https://tasknotes.dev/settings/task-defaults

Shows how to combine static path segments with template variables for organizing tasks.

```text
Work/{{project}}/{{year}}/{{status}}
Archive/{{year}}/{{month}}/{{project}}
```

--------------------------------

### Get Delivery History

Source: https://tasknotes.dev/webhooks

Retrieves the last 100 webhook delivery attempts from memory.

```APIDOC
## GET /api/webhooks/deliveries

### Description
Retrieves the last 100 in-memory webhook deliveries.

### Method
GET

### Endpoint
/api/webhooks/deliveries
```

--------------------------------

### Example: Canonical datetime write for time entries

Source: https://tasknotes.dev/spec/03-temporal-semantics

Shows the conversion of local time entries with offsets to a canonical UTC format for writing. This ensures consistent data representation.

```text
timeEntries:
  - startTime: 2026-02-20T09:30:00+01:00
    endTime: 2026-02-20T10:00:00+01:00
copy
```

```text
timeEntries:
  - startTime: 2026-02-20T08:30:00Z
    endTime: 2026-02-20T09:00:00Z
copy
```

--------------------------------

### Get Calendars Overview

Source: https://tasknotes.dev/HTTP_API

Returns an overview of provider connectivity and subscription counts for calendars.

```APIDOC
## GET /api/calendars

### Description
Returns provider connectivity overview and subscription counts.

### Method
GET

### Endpoint
/api/calendars
```

--------------------------------

### Initialize a Standalone TaskNotes Collection

Source: https://tasknotes.dev/mdbase-tasknotes-cli

Create a new, standalone TaskNotes collection in a specified directory and configure mdbase-tasknotes to use it.

```bash
mtn init ~/tasks
mtn config --set collectionPath=~/tasks
```

--------------------------------

### Get Task Time Summary

Source: https://tasknotes.dev/HTTP_API

Retrieves the time summary and entries for a specific task.

```APIDOC
## GET /api/tasks/:id/time

### Description
Returns per-task time summary and entries.

### Method
GET

### Endpoint
/api/tasks/:id/time
```

--------------------------------

### Task Dependency Example

Source: https://tasknotes.dev/features/task-management

Demonstrates how to define task dependencies in YAML frontmatter, including the blocking task UID, relationship type, and optional gap duration.

```yaml
blockedBy:
  - uid: "[[Operations/Order hardware]]"
    reltype: FINISHTOSTART
    gap: P1D
```
Tokens:
Raw