Integration and Automation
Just as OmniFocus is an integral part of your life, we strive to deeply integrate OmniFocus into the system of whichever device you are using.
As part of helping you to accomplish more every day — anywhere you go!, we continue updating OmniFocus:
- OmniFocus 4.3 added support for System Focus, and a new Set Favorite Perspetive action.
- OmniFocus 4.4 began our transition to App Intents, adding Quick Entry, Quick Open, and Open Perspective actions, while also updating Siri capture on Apple Watch.
- OmniFocus 4.5 continued our migration to App Intents, adding or updating Add Action, Add TaskPaper, Complete Action, Complete Project, Find Actions (Beta), Find Folder, Find Projects, Find Tags, Get Action, Get Actions from Perspective, Get Folder, Get Perspective, Get Project, Get Tag, Open Action, Open Folder, Open Project, Open Tag, and Today’s Forecast, while also bringing cross-platform parity to Spotlight.
- OmniFocus 4.7 expanded that support to include Planned Dates, improved Repeats, and Mutually Exclusive Tags.
- OmniFocus 4.9 completes our transition to App Intents, adds new and expanded Shortcuts Actions, and supports interacting with your database using Siri AI (Beta).
OmniFocus supports a wide range of Apple technologies, including:
In addition to the available Apple technologies, we have our own cross-platform automation system: Omni Automation!
Apple Intelligence
Apple Intelligence is available on Mac, iPhone, iPad, Apple Watch, and Apple Vision Pro, if your device meets the minimum system requirements:
As Apple continues to update Apple Intelligence, we evaluate each new feature to determine which will help you accomplish more in OmniFocus. OmniFocus currently supports:
To learn more about Apple Intelligence, see these Apple articles:
You will automatically view the OS 27 version of these articles. If you are running an older operating system, use the Select version: menu at the top of the page to get appropriate information.
Foundation Models
OmniFocus 4 includes support for Apple’s Foundation Models framework, both as part of our enhanced Date Parsing with Apple Intelligence, and as part of your Omni Automation workflows.
Genmoji
Genmoji can be used in titles and notes.
To learn more about creating Genmoji, see these Apple User Guide articles:
Shortcuts Actions for Apple Intelligence
The Shortcuts app supports Apple Intelligence actions, which can be combined with the OmniFocus actions described below.
As of the time of writing, Apple Intelligence actions include using a cloud, on-device, or ChatGPT language model; creating an image using Image Playground; or incorporating Writing Tools into your workflow.
To learn more about using Apple Intelligence with Shortcuts, see these Apple User Guide articles:
Writing Tools
Writing Tools are available for row titles, row notes, and text contained in any cell.
To use Writing Tools, select the text you want to modify, then choose Show Writing Tools from the Shortcut Menu; on Mac, you can also select Writing Tools from the Edit Menu.
If you select a row (instead of text inside the row), Writing Tools will focus on the row title, but is unable to successfully Replace the title. You can still Copy and Paste the result manually.
To learn more about using Writing Tools, see these Apple User Guide articles:
Siri AI (Beta)
Siri AI is an enhanced and more powerful version of Siri. Siri AI is currently available as a Beta feature from Apple, available on recent devices, beginning with the release of OS 27. For general information about Siri AI, please read Apple’s page about Apple Intelligence and Siri.
OmniFocus support for Siri AI is available on Mac, iPhone, iPad, and Apple Vision Pro.
Please note that Siri AI is a Beta release, and may yield unexpected or incorrect results.
Siri AI support is currently more robust on iPhone, iPad, and Apple Vision Pro. As Siri AI receives further updates, our goal is to have OmniFocus support Siri AI identically across all supported devices, including Mac.
Please feel free to Email Support to report issues, ask questions, and help us improve our support for Siri AI in ways which help you accomplish more every day.
Configuring Siri AI
For device-specific information from Apple, including which devices support Siri AI and how to request access to the Beta, see this Apple article:
and these Apple User Guide articles:
Once Apple has granted access to Siri AI, OmniFocus should automatically be included in your Siri AI learning and results. If you want to confirm that OmniFocus is included:
- Open System Settings.
- Select Siri.
- Select App Access.
- Select OmniFocus.
- Under Allow OmniFocus.app to Use Data for, turn on the option for Learn from this application.
How OmniFocus Shares with Siri AI
OmniFocus integrates with Siri AI using Apple’s Reminders app schema, which provides the closest match to OmniFocus features, and allows you to use OmniFocus in most places you can use Reminders.
Since we are using the Reminders app schema, Siri AI requires using Reminders-based terms to interact with OmniFocus, and only supports interactions that are possible in both Reminders and OmniFocus. Features which are not supported by Reminders, such as Planned Dates, can not be added or edited using Siri AI. Remember that you can always start with Siri AI, and then use the full range of OmniFocus features to get everything just the way you like!
Supported Reminders terms include:
As of OmniFocus 4.9 and OS 27.0, OmniFocus supports using Siri AI to:
You can also Activate Siri to ask questions about your reminders, lists, and groups. Please read each section, to learn more about the information you can ask about:
As of OmniFocus 4.9 and OS 27.0, Siri AI on Mac only supports asking about your reminders, lists, and groups by title.
Siri AI on iPhone, iPad, and Apple Vision Pro supports asking about all the information in the sections linked
Reminders with Siri AI
As of OmniFocus 4.9 and OS 27.0, OmniFocus supports using Siri AI to:
- Create reminders (actions and inbox items)
- Open reminders (actions and inbox items)
- Update reminders (actions and inbox items)
- Delete reminders (actions and inbox items)
Siri AI supports the following properties when creating, updating, opening, or asking about reminders:
- Title
- Project
- Tags
- Flag
- Due Date
- Repeat
- Note and URLs
- Added Date
- Status, if active or completed
- Completed Date
- Location
A few things to keep in mind:
- Siri expects you to refer to projects as lists.
- You can assign or update tags, but Siri doesn’t know anything about the hierarchy or relationship of tags, so features like mutually exclusive tags won’t work.
- Assigning a location only works if you have a matching tag, which has both a fixed Location (Here, Address, Contact, Pin) and Location Notification (When Arriving, When Leaving).
Some phrases you might want to try:
- Remind me to take out the trash every Friday, in OmniFocus.
- Can you open my reminder about researching a new computer?
- Can you update the due date for my reminder about grocery shopping to tomorrow?
Lists with Siri AI
As of OmniFocus 4.9 and OS 27.0, OmniFocus supports using Siri AI to:
- Create lists (projects)
- Open lists (projects)
Siri AI supports the following properties when creating, opening, or asking about lists:
You can also create a list containing reminders, or ask Siri to turn a reminder into a list of reminders with more detail.
If you’re not sure how to accomplish a task, ask Siri to research it for you, then create a new list with reminders for you to work through.
Some phrases you might want to try:
- Please research a good lasagna recipe, and create a new list containing ingredient I need to buy, in OmniFocus
- Can you open my chores list in OmniFocus?
- I would like to read “The Hobbit” and “The Lord of the Rings” series. Please create a list for each book, with a reminder for each chapter, and add due dates so that I can complete the series in the next quarter.
Groups with Siri AI
As of OmniFocus 4.9 and OS 27.0, OmniFocus supports using Siri AI to:
- Open groups (folders)
Siri AI supports the following properties when opening or asking about groups:
A phrase you might want to try:
- Please open my family group in OmniFocus
Activating Siri
There are many ways of activating Siri, depending on the device and platform. These often include:
- Using the new Siri app.
- Using the “Siri” or “Hey, Siri” commands.
- Using the Spotlight bar.
- And many other options!
To learn more about activating Siri, see these Apple User Guide articles:
When you first start working with Siri AI and OmniFocus, you will need to include “in OmniFocus” in your conversation, such as “please remind me to buy some milk in OmniFocus.” As you continue working with Siri AI and OmniFocus, and as Siri learns that you use OmniFocus for your reminders and lists, you may find that you can eventually drop “in OmniFocus” from your conversation, such as “remind me to call my parents.”
Siri App
OS 27 includes a new Siri app, which unites all of your Siri conversations into a single location, and syncs them between your Siri AI-compatible devices.
While developing the Siri AI support in OmniFocus, our team has found the Siri app valuable for exploring what is possible with Siri AI. You can type or talk to Siri, easily scroll back to review your conversation thus far, and continue your conversation using already established context, or return to older conversations along with the previous context.
To learn more about the Siri app, see these Apple User Guide articles:
Onscreen Awareness
Onscreen awareness allows Siri AI (Beta) to see everything on your screen, including OmniFocus. You can ask Siri about items that you see in OmniFocus, and update them by Activating Siri or using the Siri App.
You can also ask Siri about other items on your screen, such as a website you would like to read later, a photo of a place to visit, or a document you are editing, and then create related reminders in OmniFocus.
You can:
Some phrases you might want to try:
- Mark the first three reminders complete.
- Which of my reminders are most important?
- Remind me to research this website tomorrow evening.
To learn more about Onscreen awareness, see these Apple User Guide articles:
Onscreen awareness is not available on Apple Vision Pro.
Visual Intelligence
You can interact with photos of objects or to-do lists, adding related reminders and lists to OmniFocus, or capture reminders and lists about items you see around you.
To learn more about Visual Intelligence see these Apple User Guide articles:
Spotlight with Siri AI
Spotlight with Siri AI is supported on iPhone, iPad, and Apple Vision Pro.
Building on the power of Spotlight, Siri knows about the content of your database, including remaining and recently completed items.
Voice Control
If you would like to supplement the OmniFocus integration with Siri AI, you may be interested in using Voice Control to control OmniFocus on your Mac. To learn more, visit this Omni Automation page:
Omni Automation ![Requires OmniFocus Pro]()
Omni Automation is our JavaScript-based cross-platform automation system, which is available on Mac, iPhone, iPad, and Apple Vision Pro.
To learn more about Omni Automation, please visit the What is Omni Automation? and Omni Automation in OmniFocus pages.
Plug-Ins
Omni Automation Plug-Ins are written in Apple’s Core JavaScript, and can be used to automate a wide variety of workflows.
To learn more about Omni Automation Plug-Ins, visit the Omni Automation Plug-Ins website, try building your own using The Action Template Generators, or Installing Plug-Ins from the Omni Automation Plug-Ins for OmniFocus collection.
Installing Plug-Ins
To install Omni Automation Plug-Ins on Mac:
- Add the plug-in to a Connected Folder which is configured to support Plug-Ins, such as the iCloud Drive Connected Folder.
- Double-click the plug-in, then select from On My Mac to use the plug-in on this device only, OmniFocus to add the plug-in to iCloud Drive > OmniFocus > Plug-Ins so it can be used on all your devices, or any other configured Connected Folder.
- Select Configure… from the Automation Menu, then drag the plug-in over the Automation Configuration window.
To install Omni Automation Plug-Ins on iPhone, iPad, or Apple Vision Pro:
- Add the plug-in to a Connected Folder which is configured to support Plug-Ins, such as the iCloud Drive Connected Folder.
- Tap the plug-in, then select from On My Device to use the plug-in on this device only, or OmniFocus to add the plug-in to iCloud Drive > OmniFocus > Plug-Ins so it can be used on all your devices, or any other configured Connected Folder.
- Select Configure Plug-Ins from Automation Settings (or from the Automation Menu on iPad), then drag the plug-in over the desired location header. This is easier on iPad or Apple Vision Pro, but still possible on iPhone.
Uninstalling Plug-Ins
To uninstall Omni Automation Plug-Ins on Mac:
- If it is in a Connected Folder, remove it from that folder.
- Select Configure… from the Automation Menu, Control + click on the plug-in, and select Move to Trash.
To uninstall Omni Automation Plug-Ins on iPhone, iPad, or Apple Vision Pro:
- If it is in a Connected Folder, remove it from that folder.
- Select Configure Plug-Ins from Automation Settings (or from the Automation Menu on iPad), swipe on the plug-in row from right to left, and select Delete.
Shortcuts
Shortcuts actions for OmniFocus are described below, with additional information and links to other sections of this documentation, where relevant.
You can also view our Shortcuts actions by launching the Shortcuts app,
creating a New Shortcut,
and then scrolling to the OmniFocus section.
Shortcuts allows you to search action details,
which is a quick way to find specific actions,
or narrow your search to actions affecting one primary element (such as actions or projects).
Once you have located an action,
select the
button next to the action title to show details,
including the intended purpose of the action,
as well as possible inputs and results.
If you are just getting started with Shortcuts, please start with these helpful Apple User Guide articles:
Actions by Category
When viewed in Shortcuts, OmniFocus actions are grouped in categories, based on which part of your database they primarily affect:
Remember that shortcuts can also include actions from other apps, as well as actions that are built-in to the system, including Shortcuts actions for Apple Intelligence.
If you are using Shortcuts actions from earlier versions of OmniFocus 4, those are still included as Legacy Actions.
We encourage you to update to our modern, and more flexible, App Intent-based actions as you have time.
Actions Actions
Application Actions
Beta Actions
Focus Actions
Folders Actions
Omni Automation Actions
Perspectives Actions
Projects Actions
Tags Actions
Other Actions
Shortcuts automatically creates an Other category, which includes suggested actions for you, based on how you use OmniFocus.
Actions by Type
Another way of grouping Shortcuts actions is by what type of impact they have on your database:
Actions to Add Items
Actions to Complete Items
Actions to Delete Items
Actions to Edit/Update Items
Actions to Find Items
Actions to Get Items
Actions to Open/Show Items
Actions to Update the App
Modern Actions
Our modern App Intent-based actions support all current operating systems:
- Add Action
- Add TaskPaper
- Complete Action
- Complete Project
- Delete Actions
- Edit Action
- Find Actions (Beta)
- Find Folder
- Find Perspectives
- Find Projects
- Find Tags
- Get Action
- Get Actions from Perspective
- Get Folder
- Get Perspective
- Get Project
- Get Tag
- Omni Automation Plug-In
![Requires OmniFocus Pro]()
- Omni Automation Script
![Requires OmniFocus Pro]()
- Open Action
- Open Folder
- Open Perspective
- Open Project
- Open Tag
- Quick Entry
- Quick Open
- Set Favorite Perspective
- Set OmniFocus Focus Filter
- Sync OmniFocus
- Today’s Forecast
Add Action
Added in OmniFocus 4.5
Updated in OmniFocus 4.7, 4.9
Description:
- Adds a new action to OmniFocus with the specified details.
Action:
- Add
ActiontoProjectwithDetail
Inputs:
Action— The title of the action to add.Project— The project to which the action is added.Detail— Choose to add details for:
As of OmniFocus 4.9, this action supports configuring Repeats, and using Rich Text in Notes.
This action has replaced the Legacy: Add Item action.
Add TaskPaper
Added in OmniFocus 4.5
Updated in OmniFocus 4.9
Description:
- Adds the TaskPaper passed as input into OmniFocus.
Action:
- Add
TaskPapertoTarget
Inputs:
TaskPaper— The TaskPaper formatted text to add.Target— Choose to add your text to:
For more information about TaskPaper-formatted text, read our OmniFocus TaskPaper Reference Guide.
This action has replaced the Legacy: Add TaskPaper action.
Complete Action
Added in OmniFocus 4.5
Description:
- Completes the provided action.
- If multiple actions are passed as input, only the first action will be completed.
Action:
- Complete
Action
Inputs:
Action— The action to complete.
Complete Project
Added in OmniFocus 4.5
Description:
- Completes the provided project.
- If multiple projects are passed as input, only the first project will be completed.
Action:
- Complete
Project
Inputs:
Project— The project to complete.
Delete Actions
Added in OmniFocus 4.9
Description:
- Deletes the provided actions in OmniFocus.
Action:
- Delete
Actions
Inputs:
Actions— The actions to delete.
Edit Action
Added in OmniFocus 4.9
Description:
- Sets a specific field with a new value on the provided action.
Action:
- Set
DetailofAction
Inputs:
Detail— Choose to edit the details for:Action— The action to edit.
You can also choose to clear any of the details, except for the required title.
Find Actions (Beta)
Added in OmniFocus 4.5
Updated in OmniFocus 4.7, 4.9
This action is in Beta, as using the “Tag“ result of a previous OmniFocus Shortcuts action does not yet work as the value for a “Tag“ filter. We hope that a future operating system update will resolve this issue.
Description:
- Search for actions in your OmniFocus database that match the given criteria.
Action:
- Find
Actionswhere (a filter) / where any filters / where all filters
Select Add Filter,
and select whether your Actions should match:
- Title
is,contains, orbegins witha search string or variable - Availability is First Available, Available, Remaining, Dropped, Completed, or Shortcut Input
- In Inbox
- Not in Inbox
- Project is selected project or Shortcut Input
- Tags contains selected tags or Shortcut Input
- Tagged with one or more tags
- Not Tagged with any tags
- Flagged (including Inherited Flag)
- Not Flagged (including Inherited Flag)
- Estimated Minutes
is greater than,is greater than or equal to,is less than, oris less than or equal toa Number - Defer Date
(including Inherited Defer Due)
is after,is on or after,is before, oris on or beforea Date - Planned Date
(including Inherited Planned Due)
is after,is on or after,is before, oris on or beforea Date - Due Date
(including Inherited Due Due)
is after,is on or after,is before, oris on or beforea Date - Completed Date
(including inherited date from Completed with Container)
is after,is on or after,is before, oris on or beforea Date - Dropped Date
(including inherited date from Dropped with Container)
is after,is on or after,is before, oris on or beforea Date - Item Type
isoris nota project, a group, an action, a project or group, or Shortcut Input
Options:
- Sort by — Optionally sort actions by Defer Date (including Inherited Defer Due), Planned Date (including Inherited Planned Due), Due Date (including Inherited Due Due), Completed Date (including inherited date from Completed with Container), Added Date, Modified Date, Projects Order, or Random
- Limit — Whether or not to limit the number of actions retrieved
This action has replaced the Legacy: Find Items action.
Find Folder
Added in OmniFocus 4.5
Updated in OmniFocus 4.7
Description:
- Search for folders in your OmniFocus database that match the given criteria.
Action:
- Find
Folderwhere (a filter) / where any filters / where all filters
Select Add Filter,
and select whether your Folders should match:
- Title
is,contains, orbegins witha search string or variable - Folder Status is Active, Dropped, or Shortcut Input
- Effective Folder Status is Active, Dropped with Container, or Shortcut Input
Effective Status takes into account both Status and Inherited Status.
Options:
- Sort by — Optionally sort folders by Added Date, Modified Date, Projects Order, or Random
- Limit — Whether or not to limit the number of folders retrieved
Find Perspectives
Added in OmniFocus 4.7
Description:
- Search for perspectives in OmniFocus that match the given criteria.
Action:
- Find
Perspectivewhere (a filter) / where any filters / where all filters
Select Add Filter,
and select whether your Perspectives should match:
Options:
- Sort by — Optionally sort perspectives by Added Date, Modified Date, or Random
- Limit — Whether or not to limit the number of perspectives retrieved
Find Projects
Added in OmniFocus 4.5
Updated in OmniFocus 4.7, 4.9
Description:
- Search for projects in your OmniFocus database that match the given criteria.
Action:
- Find
Projectswhere (a filter) / where any filters / where all filters
Select Add Filter,
and select whether your Projects should match:
- Title
is,contains, orbegins witha search string or variable - Project Status is Active, On Hold, Completed, Dropped, or Shortcut Input
- Effective Project Status is Active, On Hold, Completed, Dropped with Container, or Shortcut Input
- Folder
isoris notShortcut Input
Effective Status takes into account both Status and Inherited Status.
Options:
- Sort by — Optionally sort projects by Added Date, Modified Date, Projects Order, or Random
- Limit — Whether or not to limit the number of actions retrieved
This action has replaced the Legacy: Find Projects action.
Find Tags
Added in OmniFocus 4.5
Updated in OmniFocus 4.7
Description:
- Search for tags in your OmniFocus database that match the given criteria.
Action:
- Find
Tagswhere (a filter) / where any filters / where all filters
Select Add Filter,
and select whether your Tags should match:
- Title
is,contains, orbegins witha search string or variable - Tag Status is Active, On Hold, Dropped, or a variable
- Effective Tag Status is Active, On Hold, Dropped with Container, or a variable
Effective Status takes into account both Status and Inherited Status.
Options:
- Sort by — Optionally sort tags by Added Date, Modified Date, Tags Order, or Random
- Limit — Whether or not to limit the number of tags retrieved
This action has replaced the Legacy: Find Tags action.
Get Action
Added in OmniFocus 4.5
Description:
- Gets an action from the provided input.
- Accepts an Action URL or ID.
Action:
- Get Action from
Action URL or ID
Inputs:
Action URL or ID— Any URL for an action generated using Copy as Link, or the ID portion of that URL.
This action, in combination with other Modern Actions, has replaced the Legacy: Get Database Object Result from Input action.
Get Actions from Perspective
Added in OmniFocus 4.5
Description:
- Returns any actions currently appearing in the specified perspective.
Action:
- Get Actions from
Perspective
Inputs:
Perspective— Any Standard Perspectives or Custom Perspectives
.
This Shortcuts action is the equivalent of viewing any of the
Standard Perspectives
or
Custom Perspectives
.
For a Forecast-specific version of this action, use the Today’s Forecast action.
Get Folder
Added in OmniFocus 4.5
Description:
- Gets a folder from the provided input.
- Accepts a Folder URL or ID.
Action:
- Get Folder from
Folder URL or ID
Inputs:
Folder URL or ID— Any URL for a folder generated using Copy as Link, or the ID portion of that URL.
This action, in combination with other Modern Actions, has replaced the Legacy: Get Database Object Result from Input action.
Get Perspective
Added in OmniFocus 4.5
Description:
- Gets a perspective from the provided input.
- Accepts a Perspective URL or ID.
Action:
- Get Perspective from
Perspective URL or ID
Inputs:
Perspective URL or ID— Any URL for a perspective generated using Copy as Link, or the ID portion of that URL.
This action, in combination with other Modern Actions, has replaced the Legacy: Get Database Object Result from Input action.
Get Project
Added in OmniFocus 4.5
Description:
- Gets a project from the provided input.
- Accepts a Project URL or ID.
Action:
- Get Project from
Project URL or ID
Inputs:
Project URL or ID— Any URL for a project generated using Copy as Link, or the ID portion of that URL.
This action, in combination with other Modern Actions, has replaced the Legacy: Get Database Object Result from Input action.
Get Tag
Added in OmniFocus 4.5
Description:
- Gets a tag from the provided input.
- Accepts a Tag URL or ID.
Action:
- Get Tag from
Tag URL or ID
Inputs:
Tag URL or ID— Any URL for a tag generated using Copy as Link, or the ID portion of that URL.
This action, in combination with other Modern Actions, has replaced the Legacy: Get Database Object Result from Input action.
Omni Automation Plug-In ![Requires OmniFocus Pro]()
Added in OmniFocus 4.9
Description:
- Runs an action from an Omni Automation plug-in.
Runs an installed Omni Automation Plug-In from among the actions you have installed in OmniFocus; adding this to your shortcut provides a drop-down menu where you can select the desired Omni Automation action to run.
Action:
- Run the
Plug-In ActionOmni Automation Plug-In
Inputs:
Plug-In Action— Any installed Omni Automation Plug-In for OmniFocus
To learn more about incorporating Omni Automation into your Shortcuts workflows, visit the Omni Automation and Shortcuts page on the Omni Automation website, and try Installing Plug-Ins from the Omni Automation Plug-Ins for OmniFocus collection.
This action has replaced the Legacy: Omni Automation Plug-In action.
Omni Automation Script ![Requires OmniFocus Pro]()
Added in OmniFocus 4.9
Description:
- Runs an Omni Automation script, using optional input from another Shortcuts action.
Action:
- Run a script with
Inputvia Omni Automation
Inputs:
Input— Result from another Shortcuts action.Script— Omni Automation script, using JavaScript.Associated Files— Files to be used by the script.
To learn more about incorporating Omni Automation into your Shortcuts workflows, see Omni Automation and Shortcuts on the Omni Automation website.
This action has replaced the Legacy: Omni Automation Script action.
Open Action
Added in OmniFocus 4.5
Description:
- Open the provided action in OmniFocus.
Action:
- Open
Action
Inputs:
Action— Action selected from search results, or as an input from another Shortcuts action.
This action, in combination with other Modern Actions, has replaced the Legacy: Show in OmniFocus action.
Open Folder
Added in OmniFocus 4.5
Description:
- Open the provided folder in OmniFocus.
Action:
- Open
Folder
Inputs:
Folder— Folder selected from search results, or as an input from another Shortcuts action.
This action, in combination with other Modern Actions, has replaced the Legacy: Show in OmniFocus action.
Open Perspective
Added in OmniFocus 4.4
Updated in OmniFocus 4.5
Description:
- Open the provided perspective in OmniFocus.
Action:
- Open
Perspective
Inputs:
Perspective— Perspective selected from search results, or as an input from another Shortcuts action.
This action, in combination with other Modern Actions, has replaced the Legacy: Show in OmniFocus action.
Open Project
Added in OmniFocus 4.5
Description:
- Open the provided project in OmniFocus.
Action:
- Open
Project
Inputs:
Project— Project selected from search results, or as an input from another Shortcuts action.
This action, in combination with other Modern Actions, has replaced the Legacy: Show in OmniFocus action.
Open Tag
Added in OmniFocus 4.5
Description:
- Open the provided tag in OmniFocus.
Action:
- Open
Tag
Inputs:
Tag— Tag selected from search results, or as an input from another Shortcuts action.
This action, in combination with other Modern Actions, has replaced the Legacy: Show in OmniFocus action.
Quick Entry
Added in OmniFocus 4.4
Description:
- Displays Quick Entry in OmniFocus.
Action:
- Start Quick Entry
Inputs:
- No inputs
- Launches OmniFocus, and presents Quick Entry
Quick Open
Added in OmniFocus 4.4
Description:
- Displays Quick Open in OmniFocus.
Action:
- Start Quick Open
Inputs:
- No inputs
- Launches OmniFocus, and presents Quick Open
Set Favorite Perspective
Added in OmniFocus 4.3
Description:
- Turns on, turns off, or toggles the favorite status of one or more Perspectives.
Action:
BooleanPerspectivesas favorite
Inputs:
Boolean— Choose whether toTurn On,Turn Off, orToggleselected perspectives as Favorites.Perspectives— One or more Standard Perspectives or Custom Perspectives
.
Set OmniFocus Focus Filter
Description:
- Sets the behavior of the OmniFocus app when the given Focus is enabled.
Action:
SetOmniFocus Filter while inDo Not Disturb
Inputs:
Set— Choose whether toSet,Turn On,Turn Off,Toggle, orClearthe Focus FilterDo Not Disturb— Choose which Focus to use for the basis of your filter.
Sync OmniFocus
Added in OmniFocus 4.5.2
Description:
- Launches OmniFocus in the background, and initiates a sync attempt.
- Waits until the sync attempt is completed before continuing with the next action.
- Errors in configuration or network access will stop execution of the shortcut, and an alert will be presented.
Action:
- Sync OmniFocus
Inputs:
- No inputs
Today’s Forecast
Added in OmniFocus 4.5
Description:
- Gets items for today from your Forecast, including tagged, flagged, and deferred items if those options are selected in View Options.
For additional customization, use our new Get Actions from Perspective action.
This Shortcuts action is the equivalent of viewing the Forecast Perspective.
This action has replaced the Legacy: Today’s Forecast action.
Legacy Actions
All legacy SiriKit-based OmniFocus Shortcuts actions, in alphabetical order:
Modern Actions cannot be combined with legacy actions, as they use two different types of Apple technology. As of OmniFocus 4.9, almost all legacy workflows can be rebuilt using modern actions, while thoroughly integrating into modern operating systems.
Legacy: Add Item
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Add Action action.
Description:
- Adds a new action to OmniFocus with the specified details.
Action:
- Add
ItemtoProject+Detail
Inputs:
Item— The title of the action to add.Project— The project to which the action is added.Detail— Choose to add details for Tags, Flagged, Estimated Minutes, Defer Date, Due Date, Attachments, Note.
Unlike Add Action, this action supports only Plain Text in the Note.
Legacy: Add TaskPaper
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Add TaskPaper action.
Description:
- Adds the TaskPaper passed as input into OmniFocus.
Action:
- Add
TaskPapertoTarget
Inputs:
Legacy: Find Items
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Find Actions action.
Description:
- Searches for the items in your OmniFocus database that match the given criteria.
Action:
- Legacy: Find
AvailableItems
Inputs:
Available— First Available, Available, Remaining, Dropped, Completed, or Ask Each Time.
This shortcut action returns Inbox Items and Actions. To find Projects or Tags instead, use Legacy: Find Projects or Legacy: Find Tags.
The “Project” and “Tags” fields provide a picker for narrowing results from the Find Items action based on project and tags. You can also dynamically provide the value for these fields using input from Legacy: Find Projects or Legacy: Find Tags.
Legacy: Find Projects
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Find Projects action.
Description:
- Searches for the projects in your OmniFocus database that match the given criteria.
Action:
- Legacy: Find Projects where title contains
anything
Inputs:
anything— Text, variable, Ask Each Time, or Shortcut Input.
This shortcut action returns Projects. To find Inbox Items, Actions, or Tags instead, use Legacy: Find Items or Legacy: Find Tags.
Legacy: Find Tags
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Find Tags action.
Description:
- Searches for the tags in your OmniFocus database that match the given criteria.
Action:
- Legacy: Find Tags where title contains
anything
Inputs:
anything— Text, variable, Ask Each Time, or Shortcut Input.
This shortcut action returns Tags. To find Inbox Items, Actions, or Projects instead, use Legacy: Find Items or Legacy: Find Projects.
Legacy: Get Database Object Result from Input
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Get Action, Get Folder, Get Perspective, Get Project, or Get Tag action.
Database Objects are representations of entities in OmniFocus that weren’t natively supported by Shortcuts. With our migration to using App Intents to build Modern Actions, the collection of Actions to Get Items is a much easier way to accomplish what this actions supports.
Inputs:
- Accepts JSON-formatted text passed in as input. The JSON attributes are “type” (with values “task”, “project”, “folder”, “tag”, or “perspective”) and “primaryKey”.
To look up an item’s Primary Key, use Copy as Link, and paste it from OmniFocus into a text field to find the unique segment at the end of the URL.
Returns a Database Object Result containing one of Folder, Item, Perspective, Project, or Tag, depending on the input. These objects can be used in the pickers found in other Legacy Actions.
Legacy: Omni Automation Plug-In ![Requires OmniFocus Pro]()
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Omni Automation Plug-In action.
Runs an installed Omni Automation Plug-In.
Action:
- Run the
Plug-In ActionOmni Automation Plug-In
Inputs:
Plug-In Action— Any installed Omni Automation Plug-In for OmniFocus
To learn more about incorporating Omni Automation into your Shortcuts workflows, visit the Omni Automation and Shortcuts page on the Omni Automation website, and try Installing Plug-Ins from the Omni Automation Plug-Ins for OmniFocus collection.
Legacy: Omni Automation Script ![Requires OmniFocus Pro]()
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Omni Automation Script action.
Runs an Omni Automation script, using optional input from another Shortcuts action.
Description:
- Runs an Omni Automation script, using optional input from another Shortcuts action.
Action:
- Run a script with
Inputvia Omni Automation
Inputs:
Input— Result from another Shortcuts action.Script— Omni Automation script, using JavaScript.Associated Files— Files to be used by the script.
To learn more about incorporating Omni Automation into your Shortcuts workflows, see Omni Automation and Shortcuts on the Omni Automation website.
Legacy: Show in OmniFocus
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Open Action, Open Folder, Open Perspective, Open Project, or Open Tag action.
Shows a project, folder, tag, or perspective chosen from a list, or an item passed from the previous action. The latter is useful in combination with the Find Items action.
Legacy: Today’s Forecast
This Legacy Action is deprecated, and cannot be used in combination with Modern Actions. It will be removed in a future version of OmniFocus.
Please replace this action with our modern Today’s Forecast action.
Get items for today from your OmniFocus Forecast, including tagged and deferred items if those options are selected in Forecast View Options.
Action:
- Legacy: Today’s Forecast
With selected sections from the Forecast View Options.
Siri
Siri is available on Mac, iPhone, iPad, Apple Watch, and Apple Vision Pro:
Once you have configured a shortcut using the Shortcuts app, you can launch it using Siri.
To learn more, see these Apple User Guide articles:
For general information about Siri, these articles are useful:
Spotlight
Spotlight indexes your OmniFocus database, allowing you to quickly search for:
As well as quickly access:
Spotlight is available on Mac, iPhone, iPad, and Apple Vision Pro:
System Focus
Apple has a robust Focus system, which allows you to configure a range of device and app settings based on your current location, time of day, or area of… focus. You can also share your Focus states across devices, making it quick and easy to update everything at the same time. Customization options include Focus Filters, which allow you to automatically update OmniFocus (and other apps) when you change Focus on your devices.
To learn more about Focus, start with these Apple User Guide articles:
Focus Filters
While configuring a Focus, select Add Filter.
You can search for folders, then select one or more to use as the basis for an automatically applied Focus on Selected when you switch your device Focus.