FocusRelay is a fast, native Swift MCP server and CLI that helps AI assistants read and safely update OmniFocus using documented OmniFocus APIs.
Install with Homebrew · See what it can do · Star FocusRelay · Contribute
Ask about the work already in OmniFocus, review the answer, and make approved changes without clicking through long task lists.
FocusRelay is designed for targeted questions and compact answers, so the assistant does not need your entire OmniFocus database for routine requests.
Try prompts like:
- “Help me process my OmniFocus inbox in a small batch.”
- “How many flagged items do I have?”
- “Show me the first three available tasks in my inbox.”
- “Find my task called [task name], flag it, and verify the change.”
- “Set [task name] due tomorrow at 5 PM in my local timezone and verify the change.”
In clients that expose MCP server prompts, select process_inbox. In OpenCode,
run /focusrelay:process_inbox to start the guided workflow.
CLI-based agents can retrieve the exact same instructions with
focusrelay workflow get process_inbox; use focusrelay workflow list to
discover available workflows without loading their full text.
These workflows were tested with multiple MCP-capable models in OpenCode. Updates target stable OmniFocus IDs and can verify the saved result. If names are duplicated, ask to see the candidates before changing anything.
The current release can:
- guide supported MCP clients and CLI-based agents through a bounded, approval-first inbox workflow;
- find and count tasks using dates, flags, tags, projects, availability, inbox state, completion, estimates, and text search;
- review projects, folders, tags, task counts, and stalled work;
- update names, notes, flags, dates, estimates, tags, project settings, and review intervals;
- mark active and on-hold projects reviewed using OmniFocus's native review timestamp and next-review semantics;
- drop, restore, complete, reactivate, and move existing tasks;
- complete, reactivate, change status, and move existing projects;
- preview a proposed change and verify the saved result.
The current release updates existing tasks and projects. Creating or deleting items is not supported; creation is tracked in #82 and #83.