OmniFocus Automation

OmniFocus

Control OmniFocus via JXA (JavaScript for Automation).

Requirements

Quick Reference

# Run via the wrapper script
./scripts/of  [args...]
Or directly
osascript -l JavaScript ./scripts/omnifocus.js  [args...]

Commands

List/Query

| Command | Description | |---------|-------------| | inbox | List inbox tasks | | folders | List all folders | | projects [folder] | List projects, optionally filtered by folder | | tasks | List tasks in a project | | tags | List all tags | | today | Tasks due today or overdue | | flagged | Flagged incomplete tasks | | search | Search tasks by name | | info | Full task details |

Create

| Command | Description | |---------|-------------| | add [project] | Add task to inbox or project | | newproject [folder] | Create project | | newfolder | Create top-level folder | | newtag | Create or get tag |

Modify

| Command | Description | |---------|-------------| | complete | Mark complete | | uncomplete | Mark incomplete | | delete | Permanently delete | | rename | Rename task | | note | Append to note | | setnote | Replace note | | defer | Set defer date (YYYY-MM-DD) | | due | Set due date | | flag [true\|false] | Set flagged | | tag | Add tag (creates if needed) | | untag | Remove tag | | move | Move to project |

Repeat

# repeat    
of repeat abc123 fixed 1 weeks
of repeat abc123 due-after-completion 2 days
of repeat abc123 defer-after-completion 1 months
of unrepeat abc123

Methods: fixed, due-after-completion, defer-after-completion Units: days, weeks, months, years

Output Format

All commands return JSON. Success responses include "success": true. Errors include "error": "message".

{
  "success": true,
  "task": {
    "id": "abc123",
    "name": "Task name",
    "note": "Notes here",
    "flagged": false,
    "completed": false,
    "deferDate": "2026-01-30",
    "dueDate": "2026-02-01",
    "project": "Project Name",
    "tags": ["tag1", "tag2"],
    "repeat": {"method": "fixed", "rule": "RRULE:FREQ=WEEKLY;INTERVAL=1"}
  }
}

Examples

# Add task to inbox
of add "Buy groceries"
Add task to specific project
of add "Review docs" "Work Projects"
Set due date and flag
of due abc123 2026-02-01
of flag abc123 true
Add tags
of tag abc123 "urgent"
of tag abc123 "home"
Create recurring task
of add "Weekly review" "Habits"
of repeat xyz789 fixed 1 weeks
Search and complete
of search "groceries"
of complete abc123
Get today's tasks
of today

Notes

Technical Details

This skill uses JavaScript for Automation (JXA) for most operations, with AppleScript fallbacks for tag and repeat operations (due to known JXA type conversion bugs with these specific OmniFocus APIs).

The hybrid approach provides:

First run: OmniFocus may prompt to allow automation access. Enable this in System Settings > Privacy & Security > Automation.

# Add task to inbox
of add "Buy groceries"
Add task to specific project
of add "Review docs" "Work Projects"
Set due date and flag
of due abc123 2026-02-01
of flag abc123 true
Add tags
of tag abc123 "urgent"
of tag abc123 "home"
Create recurring task
of add "Weekly review" "Habits"
of repeat xyz789 fixed 1 weeks
Search and complete
of search "groceries"
of complete abc123
Get today's tasks
of today