folderName

Create a new project.

Create multiple tasks and projects in one operation. Each item accepts the same fields as addomnifocustask / addproject, plus type (task or project) and optional hierarchy helpers:

Remove multiple tasks or projects in one operation. Each item takes id or name, plus itemType.

Create a tag, optionally nested under an existing parent.

Get the complete state of your database. Use for comprehensive analysis; prefer queryomnifocus for anything targeted.

Edit an existing task or project. Also the way to move items — set newProjectName to move a task into a project, or to ""/"inbox" to send it to the inbox.

What to query: tasks, projects, or folders

Get the items visible in a named perspective.

(optional): hide completed/dropped tasks (default: true)

(optional): hide duplicate instances of recurring tasks (default: true)

or name: which item to edit (id takes precedence)

, includeCustom (optional, default: true)

(optional, default: false)

task or project

(optional, default: 100), includeMetadata (optional), fields (optional)

List available perspectives, both built-in and custom (custom perspectives are an OmniFocus Pro feature).

List all tags with their hierarchy, active status, and task counts.

, dueDate, deferDate, plannedDate, flagged, estimatedMinutes, tags (all optional)

/ parentTagID (optional; ID takes precedence)

/ parentTaskName (optional): nest under an existing task

nest this item under another batch item's tempId

e.g. Inbox, Flagged, or a custom perspective name

(optional): project to add the task to (defaults to inbox)

Query tasks, projects, or folders with targeted filters — much faster and lighter than dumping the whole database. See QUERYTOOLREFERENCE.md for the full reference and QUERYTOOLEXAMPLES.md for worked examples.

Remove a task or project.

(optional): whether tasks must be completed in order

a temporary ID other items in the same batch can reference