omnifocus-mcp MCP Server

Disclaimer: pardon the stiffness of the documentation and commits language, the project is fully coded via Claude Code, ao many messages are either as fun as an accounting report (with random…

Local serverstdioMIT

What is the omnifocus-mcp Server?

omnifocus-mcp is an MCP project maintained in the duquesnay/omnifocus-mcp repository. The maintainer describes its purpose as “Disclaimer: pardon the stiffness of the documentation and commits language, the project is fully coded via Claude Code, ao many messages are either as fun…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares LOG_LEVEL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_tasksAdvanced task filtering with smart caching
get_task_countGet count of tasks matching filters without data
create_taskCreate new tasks in inbox
update_taskUpdate existing tasks
complete_taskMark tasks as completed
delete_taskRemove tasks
list_projectsList and filter projects with caching
create_projectCreate new projects with folder support
update_projectUpdate project properties
complete_projectMark projects as done
delete_projectRemove projects from OmniFocus

How to install the omnifocus-mcp Server

{
  "mcpServers": {
    "omnifocus": {
      "command": "node",
      "args": [
        "/path/to/omnifocus-cache-by-windsurf/dist/index.js"
      ],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LOG_LEVELDeclared in the maintainer’s client configuration.Check documentation