note_set
Replace the plain-text note on a task or project. Clear the note by passing null, or provide new text to overwrite.
Instructions
Replace the plain-text note on a task or project. Overwrites the existing note entirely. Pass note: null to clear the note. To add text without overwriting use note_append instead. Returns { updated: true, id, targetKind, name, note } — name is the parent task/project's display name (pre-fetched so the response describes the change without a follow-up read); note echoes back the final content after writing (or null if cleared). Side effects: writes to OmniFocus, sets meta.syncPending = true. Call sync_trigger when you need the change to appear on other devices. Example: note_set({ targetKind: "task", id: "abc123", note: "Check with Alice first" })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Persistent ID of the task or project. Get task IDs from task_list; project IDs from project_list. | |
| note | Yes | New note text. Pass null to clear the note entirely. | |
| targetKind | Yes | The kind of OmniFocus item whose note to set. |