FocusRelaySAFE
Fast native Swift OmniFocus MCP server and CLI for macOS. Let AI assistants safely read, update, complete, and organize tasks and projects through documented Omni Automation APIs.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Plan your day and keep OmniFocus up to date with AI
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.
Ask. Review. Update.
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, es
08bac059955bOBSERVED · 2026-10-08Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (3)
.swift-version
imgs/omnifocusaiquery.gif
Gates applied: no_behavioural_pass.
08bac059955bfull audit observations/trust-audit/mcp-server/deverman__focusrelay.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 08bac059955b | SAFE | B | 89 | first audit |
Questions
What is the FocusRelay MCP server?
Fast native Swift OmniFocus MCP server and CLI for macOS. Let AI assistants safely read, update, complete, and organize tasks and projects through documented Omni Automation APIs.
Is FocusRelay safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does FocusRelay need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (08bac059955b), read on 2026-10-08. The repository is watched and re-audited when it changes.