query_omnifocus

MCP tool from OmniFocus MCP by themotionmachine

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.

How to use it

Project documentation lists query_omnifocus for the OmniFocus MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install OmniFocus MCP

$claude mcp add omnifocus -- npx -y omnifocus-mcp

FULL OMNIFOCUS MCP LISTING

Other tools in OmniFocus MCP (11)

add_omnifocus_task

Create a new task.

add_project

Create a new project.

batch_add_items

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:

batch_remove_items

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

create_tag

Create a tag, optionally nested under an existing parent.

dump_database

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

edit_item

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.

get_perspective_view

Get the items visible in a named perspective.

list_perspectives

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

list_tags

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

remove_item

Remove a task or project.