# Omnifocus Mcp

> MCP server for OmniFocus integration - enables Claude and other MCP clients to interact with OmniFocus projects

- **Type:** MCP server
- **Install:** `agentstack add mcp-s-morgan-jeffries-omnifocus-mcp`
- **Verified:** Pending review
- **Seller:** [s-morgan-jeffries](https://agentstack.voostack.com/s/s-morgan-jeffries)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [s-morgan-jeffries](https://github.com/s-morgan-jeffries)
- **Source:** https://github.com/s-morgan-jeffries/omnifocus-mcp

## Install

```sh
agentstack add mcp-s-morgan-jeffries-omnifocus-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# OmniFocus MCP Server

[](https://github.com/s-morgan-jeffries/omnifocus-mcp/actions/workflows/test.yml)
[](https://github.com/s-morgan-jeffries/omnifocus-mcp)
[](https://www.python.org)
[](LICENSE)

A comprehensive, fast, reliable, and agent-friendly MCP server for OmniFocus on macOS.

## Why This Server

### Comprehensive

21 tools covering projects, tasks, folders, tags, perspectives, and focus. Full CRUD with unified batch operations (Pydantic model inputs), 20+ filter types on task and project queries, and date management including recurrence (RRULE read/write).

### Fast

Sub-second reads on filtered queries, even with hundreds of tasks in the database.

| Operation | Time | Items | Database |
|-----------|------|-------|----------|
| Get flagged tasks | 0.66s | 14 | 202 tasks |
| Get overdue tasks | 0.69s | 8 | 202 tasks |
| Get next tasks | 0.66s | 27 | 202 tasks |
| Get inbox tasks | 0.64s | 10 | 202 tasks |
| Search tasks by keyword | 1.07s | 37 | 202 tasks |
| Get all tasks (unfiltered) | 2.20s | 202 | 202 tasks |
| Get all projects | 0.57s | 35 | 35 projects |
| Create or update a task | 0.9s | — | — |

Full profiling data: [PERFORMANCE_PROFILING.md](docs/reference/PERFORMANCE_PROFILING.md)

### Reliable

93% code coverage from 1027 unit tests. 192 integration and E2E tests run against real OmniFocus, plus 5 protocol-level smoke tests verifying the full MCP JSON-RPC transport. Tests cover task, project, and tag lifecycles, filtering, hierarchy, dates, recurrence, and review workflows.

### Agent-Friendly

73-scenario blind eval suite with frontier models scoring 100% and popular open-weight models scoring 90-94% ([full results](evals/agent_tool_usability/results/scored_results.md)). Agents that have never seen OmniFocus can correctly use every tool from descriptions alone. Scenarios cover tool selection, parameter usage, multi-step workflows, date semantics, recurrence, tag behavior, task movement, text search, and safety-critical operations (drop vs delete, destructive action guardrails). Server instructions teach GTD concepts (task states, project types, sequential dependencies, review cycles) so agents make informed decisions, not just API calls.

## Tools (21)

### Projects (6)
- **get_projects** — filter by ID, query, status; includes dates, review info, task health, stalled detection
- **create_project** — with folder placement, dates, review interval, project type
- **update_project** — all properties: name, note, status, dates, folder, review settings
- **update_projects** — batch update (status, dates, folder, review settings)
- **delete_projects** — single or batch
- **reorder_project** — position relative to siblings within a folder (before/after)

### Tasks (6)
- **get_tasks** — 14 filter types: by ID, project, parent, tags, status, dates, flags, text search, inbox
- **create_task** — with dates, tags, flags, estimated time, parent task, sequential
- **update_task** — all properties including recurrence (RRULE), tags (replace/add/remove), hierarchy
- **update_tasks** — batch update (dates, flags, tags, status, project)
- **delete_tasks** — single or batch
- **reorder_task** — position relative to siblings (before/after)

### Folders (3)
- **get_folders** — hierarchy with paths
- **create_folder** — with optional parent
- **update_folder** — rename or move to different parent

### Tags (4)
- **get_tags** — with status and mutual exclusivity info
- **create_tag** — with parent nesting and exclusivity
- **update_tag** — name, status, exclusivity
- **delete_tags** — single or batch

### Perspectives (2)
- **get_perspectives** — list with type info
- **switch_perspective** — navigate to perspective

### Navigation (2)
- **set_focus** — focus on projects/folders or clear
- **get_focus** — current focus state

## Prerequisites

- macOS with OmniFocus installed
- Python 3.10+
- [uv](https://docs.astral.sh/uv/) package manager

## Installation

```bash
git clone https://github.com/s-morgan-jeffries/omnifocus-mcp.git
cd omnifocus-mcp
git checkout v0.13.2  # Latest stable release

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync --dev
```

## Configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "omnifocus": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/omnifocus-mcp",
        "run",
        "omnifocus-mcp"
      ]
    }
  }
}
```

### Other MCP Clients

```bash
python -m omnifocus_mcp.server_fastmcp
```

Communicates via stdin/stdout using the MCP protocol.

## Permissions

macOS will prompt for:
- Accessibility access (to control OmniFocus via AppleScript)
- Automation permissions for OmniFocus

## Contributing

Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/s-morgan-jeffries/omnifocus-mcp/issues).

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [s-morgan-jeffries](https://github.com/s-morgan-jeffries)
- **Source:** [s-morgan-jeffries/omnifocus-mcp](https://github.com/s-morgan-jeffries/omnifocus-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-s-morgan-jeffries-omnifocus-mcp
- Seller: https://agentstack.voostack.com/s/s-morgan-jeffries
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.