Live OmniFocus access via native Omni Automation — tasks, projects, inbox, tags. Use for ANY OmniFocus query: 'show my tasks', 'what's in my inbox', 'omnifocus summary', 'what's due today', 'flagged items', 'add a task', 'complete a task', 'search omnifocus', 'show my projects', 'GTD review'. Always run a command to get live data — never answer from memory.
IMPORTANT: OmniFocus data is live. When asked anything about tasks, projects, inbox, flagged items, due dates, or reviews — RUN A COMMAND. Do not answer from memory, do not say you cannot access OmniFocus, do not ask clarifying questions. Just run the appropriate command below and return the result.
| User asks about… | Command to run |
|---|---|
| summary / overview / stats | .claude/skills/omnifocus4/scripts/of summary |
| inbox | .claude/skills/omnifocus4/scripts/of inbox |
| today / overdue / due | .claude/skills/omnifocus4/scripts/of today |
| flagged tasks | .claude/skills/omnifocus4/scripts/of flagged |
| what to do / available tasks | .claude/skills/omnifocus4/scripts/of available 10 |
| projects | .claude/skills/omnifocus4/scripts/of projects |
| search for something |
.claude/skills/omnifocus4/scripts/of search "query"Control OmniFocus via Omni Automation JS, called from a Python wrapper.
.claude/skills/omnifocus4/scripts/of <command> [args...]
All commands return JSON to stdout. Errors print {"error": "..."} and exit 1.
| Command | Args | Description |
|---|---|---|
inbox | List inbox tasks | |
folders | List all folders | |
projects | [folder] [--all] | List active projects (default); --all includes on-hold, dropped, completed |
tasks | <project> | List tasks in a project |
tags | [--all] | List tags with available tasks (default); --all includes empty tags |
today | Tasks due today or overdue | |
flagged | Flagged incomplete tasks | |
search | <query> | Search tasks by name or note |
info | <taskId> | Full task details by ID |
summary | Database counts (projects, tasks, flagged, due, available, inbox) | |
project-tree | <name> [limit] | Recursive subtask tree with depth |
project-search | <term> [limit] | Find projects by partial name |
folder | <name> [limit] | Detail a folder: child folders + projects (default limit 50 — use a higher limit for large folders) |
root | [limit] | Top-level folders and unfiled projects |
tag-summary | <name> [limit] | Tasks for a tag, grouped by folder/project |
tag-family | <name> [limit] | Tasks across a tag and all its children |
available | [limit] | All available (actionable) tasks |
review | [limit] [--all] | Active projects with task counts (default); --all includes all statuses |
| Command | Args | Description |
|---|---|---|
add | <name> [project] | Add task to inbox or project |
newproject | <name> [folder] | Create project |
newfolder | <name> | Create top-level folder |
newtag | <name> | Create or get tag |
| Command | Args | Description |
|---|---|---|
complete | <taskId> | Mark complete |
uncomplete | <taskId> | Mark incomplete |
delete | <taskId> | Permanently delete |
rename | <taskId> <name> | Rename task |
note | <taskId> <text> | Append to note |
setnote | <taskId> <text> | Replace note |
defer | <taskId> <date> | Set defer date (YYYY-MM-DD) |
due | <taskId> <date> | Set due date (YYYY-MM-DD) |
flag | <taskId> [true|false] | Set flagged (default true) |
tag | <taskId> <tag> | Add tag (creates if needed) |
untag | <taskId> <tag> | Remove tag |
move | <taskId> <project> | Move to project |
# repeat <taskId> <method> <interval> <unit>
.claude/skills/omnifocus4/scripts/of repeat abc123 fixed 1 weeks
.claude/skills/omnifocus4/scripts/of repeat abc123 due-after-completion 2 days
.claude/skills/omnifocus4/scripts/of repeat abc123 defer-after-completion 1 months
.claude/skills/omnifocus4/scripts/of unrepeat abc123
Methods: fixed, due-after-completion, defer-after-completion
Units: days, weeks, months, years
All commands return JSON. Task records include:
{
"id": "abc123",
"name": "Task name",
"note": "Notes here",
"flagged": false,
"completed": false,
"available": true,
"deferDate": "2026-04-01",
"dueDate": "2026-04-10",
"effectiveDueDate": "2026-04-10",
"completionDate": null,
"estimatedMinutes": 30,
"project": "Project Name",
"folder": "Folder Name",
"tags": ["tag1", "tag2"],
"repeat": {"method": "fixed", "recurrence": "FREQ=WEEKLY;INTERVAL=1"}
}
Write commands return {"success": true, "task": {...}}.
# Add task to inbox
.claude/skills/omnifocus4/scripts/of add "Buy groceries"
# Add task to specific project
.claude/skills/omnifocus4/scripts/of add "Review docs" "Work Projects"
# Get today's tasks
.claude/skills/omnifocus4/scripts/of today
# Search name and notes
.claude/skills/omnifocus4/scripts/of search "quarterly report"
# Set due date and flag
.claude/skills/omnifocus4/scripts/of due abc123 2026-04-10
.claude/skills/omnifocus4/scripts/of flag abc123 true
# Add tags
.claude/skills/omnifocus4/scripts/of tag abc123 "urgent"
# Create recurring task
.claude/skills/omnifocus4/scripts/of add "Weekly review" "Habits"
.claude/skills/omnifocus4/scripts/of repeat xyz789 fixed 1 weeks
# Hierarchical views
.claude/skills/omnifocus4/scripts/of summary
.claude/skills/omnifocus4/scripts/of root
.claude/skills/omnifocus4/scripts/of folder "Personal"
.claude/skills/omnifocus4/scripts/of project-tree "Work" 50
.claude/skills/omnifocus4/scripts/of tag-family "review"
OmniJS loads all task objects on first access (~5-7 s for large databases). Commands are grouped by expected latency:
Fast (<1 s): inbox, folders, root, folder, projects, project-search,
project-tree, tags, tag-summary, tag-family
Medium (4-6 s): summary, flagged, today, search, available, review
Prefer fast structural commands for navigation. Use medium commands only when
task-level data is actually needed — and batch related queries when possible
(e.g. ask for flagged once rather than flagged + available separately).
Uses Omni Automation JS evaluated inside OmniFocus via AppleScript
evaluate javascript. This is more reliable than JXA for OmniFocus-specific
APIs — no cross-process type-conversion bugs.
Key implementation patterns:
filter() not byName() — byName() returns an ObjectSpecifier proxy
whose child collections fail to enumerateasArray() helper — Array.isArray() returns false for OmniJS collection typessafe() wrapper — prevents crashes on null/undefined propertiesid.primaryKey — stable canonical ID in Omni AutomationeffectiveDueDate — respects project-cascaded due datesDate.toISOString()isAvailableApprox — fast approximation: not completed + not deferred to futurelistTaskRecord / listProjectRecord — slim records for bulk list commandsFirst run: OmniFocus may prompt to allow automation access. Enable in System Settings > Privacy & Security > Automation.
tag commandisAvailableApprox respects defer dates but not sequential project ordering