# OmniFocus MCP (MCP server)

> OmniFocus MCP is an MCP server that lets LLMs interface with your tasks and projects through the Model Context Protocol. It has 244 GitHub stars, is released under the MIT license and runs locally with npx -y omnifocus-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.

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:

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/themotionmachine/OmniFocus-MCP |
| GitHub stars | 244 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: omnifocus-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v1.17.0 (Sep 26, 2026) |
| Last commit | Sep 28, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

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

### Cursor (.cursor/mcp.json)

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

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

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

Config formats checked against the official docs on 2026-10-07.

## Tools

- `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

## Similar MCP servers

- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,368 stars, MIT, official, needs API key)
- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,192 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (7,725 stars, MIT)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create, read and edit Excel workbooks without Microsoft Excel. (4,212 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,108 stars, AGPL-3.0)
- [RevoGrid DataGrid MCP](https://appsgit.com/mcp-servers/revogrid-datagrid-mcp): Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval. (3,448 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/omnifocus-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.