OmniFocus-MCP MCP server

Let LLMs interface with your tasks and projects through the Model Context Protocol. Add, organize, and query your OmniFocus database with natural language commands.

What OmniFocus-MCP does

Summarised from the project README; check the repository for the latest details.

Tools exposed (20+)

• query_omnifocus
• Parameter – Description
• entity – What to query: `tasks`, `projects`, or `folders`
• Containers – `projectName` (case-insensitive partial match; `"inbox"` targets the inbox), `projectId`, `folderId` (includes subfolders), `folderName` (ca
• Names – `taskName` (case-insensitive partial match)
• Tags – `tags` (exact match, case-sensitive)
• Status – `status` — tasks: `Next`, `Available`, `Blocked`, `DueSoon`, `Overdue`, `Completed`, `Dropped`; projects: `Active`, `OnHold`, `Done`, `Dropp
• dump_database
• add_omnifocus_task
• add_project
• edit_item
• id – or `name`: which item to edit (id takes precedence)
• itemType – `task` or `project`
• position – without `newParentTaskId` reorders the task within its current parent.
• newParentTaskId – can't be combined with `newProjectName` (the parent decides the project). `position` can: the task is moved to the project, then placed.
• remove_item
• batch_add_items
• tempId – a temporary ID other items in the same batch can reference
• parentTempId – nest this item under another batch item's `tempId`
• batch_remove_items

Requirements

• macOS with OmniFocus installed
• Node.js 20 or later (for `npx`)
• Node.js (runs with npx)

How to install OmniFocus-MCP MCP in Claude Desktop, Cursor and VS Code

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

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

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

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

Add to config generator – combine it with other servers, or get the Windsurf format.

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/themotionmachine-omnifocus-mcp/)

Maintain this project? Get it featured for free during launch →

Compare with codebase-memory-mcp →

Related Databases MCP servers