OmniFocus MCP

{
  "mcpServers": {
    "omnifocus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "omnifocus-mcp"
      ]
    }
  }
}

claude mcp add --transport stdio omnifocus-mcp -- npx -y omnifocus-mcp

{
  "mcpServers": {
    "omnifocus-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "omnifocus-mcp"
      ]
    }
  }
}

{
  "servers": {
    "omnifocus-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "omnifocus-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• query_omnifocus

  Query tasks, projects, or folders with targeted filters — much faster and lighter than dumping the whole database.

• entity

  What to query: tasks, projects, or folders

• dump_database

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

• add_omnifocus_task

  Create a new task.

• note

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

• repeat

  (optional): make it recurring — see Repeating items

• add_project

  Create a new project.

• sequential

  (optional): whether tasks must be completed in order

• 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…

• position

  without newParentTaskId reorders the task within its current parent.

• remove_item

  Remove a task or project.

• batch_add_items

  Create multiple tasks and projects in one operation. Each item accepts the same fields as addomnifocustask /…

• batch_remove_items

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

• list_perspectives

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

• get_perspective_view

  Get the items visible in a named perspective.

• limit

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

• list_tags

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

• create_tag

  Create a tag, optionally nested under an existing parent.

• method

  start-after-completion (counts from when it's actually done), fixed (counts from the calendar regardless), or…

• unit

  day, week, month, or year

A Model Context Protocol (MCP) server that connects OmniFocus to Claude and other MCP-compatible AI assistants. This server bridges AI assistants and your OmniFocus database. Through natural conversation, an assistant can query, create, edit, and remove tasks and projects — including bulk operations. Some things you can do with it:

• mcp
• mcp-server
• modelcontextprotocol
• omnifocus
• task-management