FocusRelay
MCP server and CLI that lets AI assistants read and safely update OmniFocus on macOS
FocusRelay is an open-source MCP server for productivity. It is available on macOS and CLI.
- Pricing
- Open source
- Platforms
- macOS, CLI
- Version
- 0.10.0-beta
- Listing updated
Similar MCP servers
About FocusRelay
The README describes FocusRelay as a native Swift server and command-line tool that gives AI assistants access to OmniFocus on a Mac. Instead of pulling the whole database into a conversation, it answers targeted questions with compact results, such as counts of flagged items or the first few available inbox tasks.
Writes go through a preview-and-approve pattern: a proposed change can be previewed without saving, applied to stable task or project IDs, and then checked by reading the saved values back. The server talks to a bridge plug-in that runs inside OmniFocus and uses documented Omni Automation APIs. The README says the current release edits existing tasks and projects but does not create or delete them.
The project suits OmniFocus users on macOS who work from terminal-based AI clients such as Claude Code, OpenCode or Codex CLI. The README notes that desktop chat apps are not yet supported because of macOS access restrictions.
What it does
- Targeted task queries
- Find and count tasks by dates, flags, tags, projects, availability and inbox state, returning only the fields requested.
- Previewed edits
- Preview a proposed change to tasks or projects without saving, then apply it to stable OmniFocus IDs.
- Post-save verification
- Reads affected values back after saving and reports any mismatch as a failure.
- Project review support
- Reviews projects and folders, surfaces stalled work, and marks active or on-hold projects reviewed using OmniFocus's native timestamps.
- Guided inbox workflow
- Provides a batch-based, approval-first inbox processing workflow exposed as an MCP prompt and as a CLI command.
- Local-only operation
- Runs on the Mac with no FocusRelay-hosted service; data handling by the AI client follows that client's own terms.
Good for
- Process the OmniFocus inbox in small, approved batches
- Ask how many flagged or overdue tasks are waiting
- Set due dates or flags on named tasks and confirm the change saved
- Review stalled projects and mark active projects reviewed
- Run scripted OmniFocus queries from a shell-capable agent
Pricing
Open source
Free and MIT-licensed; no paid hosted plan described.
FocusRelay FAQ
Does FocusRelay create new tasks or projects?
No. The README says the current release updates existing tasks and projects, and that creating or deleting items is not yet supported. Creation is tracked in issues #82 and #83.
Which AI clients does FocusRelay work with?
The README lists terminal-based MCP clients: Claude Code, OpenCode and Codex CLI, plus other clients launched from a terminal. Desktop apps such as Claude Desktop are not yet supported because of macOS restrictions.
What are the system requirements?
The README requires macOS 26 or later on Apple silicon, OmniFocus 4 and Homebrew.
Does FocusRelay send my OmniFocus data to a server?
The README states that FocusRelay runs locally, has no hosted cloud service and does not send OmniFocus data to a FocusRelay-operated service. It notes that the AI client and chosen model may transmit data under their own terms.
Is FocusRelay free?
Yes. FocusRelay is open source, so you can use and self-host it for free.
What are the best alternatives to FocusRelay?
The closest alternatives to FocusRelay are Cronum Work, Omnido, Applesauce, Gesher Reminders and Todour.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.