org-update-todo

Org Update Todo

Update TODO state and planning metadata of existing headings using mcp__org__org-update-todo.

Tool — mcp__org__org-update-todo

Targeting (one of these is required)

By ID (preferred): supply id — the :ID: property value of the heading. Wins over file/heading_path when both are given.

By location: supply both file (relative path within org directory) and heading_path (slash-separated path, e.g. "Projects/Work/Task name").

Fields to update (all optional — omit what you don't want to change)

• todo_state: New keyword matching org_todo_keywords (e.g. "TODO", "DONE"). CLOSED is auto-stamped on done transitions and auto-removed on reactivation unless org_auto_closed_timestamp is disabled in config.
• priority: "A", "B", or "C".
• tags: Replaces the tag list wholesale. Each must match ^[A-Za-z0-9_@]+$. Pass an empty list [] to remove all tags.

Timestamps (ISO YYYY-MM-DD or YYYY-MM-DD HH:MM, optional repeater/warning):

• scheduled: New SCHEDULED active timestamp.

• deadline: New DEADLINE active timestamp.

• closed: New CLOSED inactive timestamp (usually auto-managed; set manually only when overriding auto-close behavior).

• Repeater syntax: +N, ++N, or .+N followed by h|d|w|m|y.

• Warning syntax: -N followed by h|d|w|m|y.

• title: Replace the heading title. Non-empty, no newlines.

• body: Replace the entire body text. Pass empty string or clear: ["body"] to remove. Setting and clearing in the same call is an error.

• properties: List of {key, value} pairs to upsert into the property drawer. Keys are case-insensitive; new keys are appended, existing keys are updated.

• remove_properties: List of property keys to delete from the drawer. Removing a non-existent key is a no-op. A key must not appear in both properties and remove_properties.

Clearing fields:

• clear: List of field names to remove entirely. Valid values: "todo_state", "priority", "tags", "scheduled", "deadline", "closed", "body".