Agent skill · operations · sundial-org
omnifocus
Manage OmniFocus tasks, projects, and folders via Omni Automation. Use for task management, to-do lists, project tracking, GTD workflows, adding/completing/editing tasks, setting due dates, managing tags, and recurring tasks. Requires OmniFocus installed on macOS.
Why this skill is useful
Adds executable scripts for managing tasks in OmniFocus that automate GTD workflows and task management.
What it needs
Requires omnifocus installed locally. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
OmniFocus Control OmniFocus via JXA (JavaScript for Automation). Requirements macOS with OmniFocus 3 or 4 installed OmniFocus must be running (or will auto-launch) Quick Reference Commands List/Query Command Description --------- ------------- inbox List inbox tasks folders List all folders projects [folder] List projects, optionally filtered by folder tasks <project> List tasks in a project tags List all tags today Tasks due today or overdue flagged Flagged incomplete tasks search <query> Search tasks by name info <taskId> Full task details Create Command 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 Modify Command 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 flag <taskId> [true\ false] Set flagged tag <taskId> <tag> Add tag (creates if needed) untag <taskId> <tag> Remove tag move <taskId> <project> Move to project Repeat 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". Examples Notes Task IDs are OmniFocus internal IDs (returned in all task responses) Dates use ISO format: YYYY-MM-DD Project and folder names are case-sensitive Tags are created automatically if they don't exist when using tag command All output is JSON for easy parsing 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). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/omnifocus