Siri and Shortcuts

2Do for Mac plugs into the macOS Shortcuts app with a full set of native actions for creating, finding, updating, completing, moving, and deleting tasks without scripting. Siri can run any shortcut you build by name. For callback-style integrations, there is also the twodo:// URL scheme.

Native Shortcuts Actions

Open the Shortcuts app, search for 2Do, and you'll find actions for the whole task model: Create Task with dates, tags, alarms, recurrence, and structured sub-tasks, Find Tasks with property filters, Get Tasks from Collection, Set Task Completion, Move Tasks, Delete Tasks, Set Tag Paused, and more. They run through the same automation engine as AppleScript and Claude Co-Work, and they work even while 2Do isn't running.

See Automate with Shortcuts for the full action catalogue, a step-by-step first shortcut, and ready-made recipes.

tip

Prefer the native actions over URL schemes wherever both can do the job: they return real task values you can chain into further actions, they validate their input, and they don't need to open the app.

Capturing Tasks with Siri

Build a capture shortcut and give it a speakable name:

1. In Shortcuts, add Ask for Input ("What needs doing?").
2. Add 2Do's Create Task action and pass the input into its Title; set the Destination parameter to a list or a parent task, and add a date or tags if you like.
3. Name the shortcut something short, such as Capture It, and say "Hey Siri, Capture It".

Siri runs the shortcut and the task lands in 2Do, whether or not the app is open.

You can also speak to 2Do directly

2Do ships its own spoken phrases, in every language 2Do speaks, so you can ask Siri to add, find, or complete a task without building a shortcut for it. Say "Add to 2Do", "Find tasks in 2Do", or "Complete a task in 2Do". Shortcuts you have named yourself keep working alongside them.

note

If you ask Siri directly to "remind me" (without naming a shortcut), the item goes to Apple's Reminders app. That still reaches 2Do if you sync with the Apple Reminders method; otherwise use a named capture shortcut so the task goes straight to 2Do.

tip

Build a Smart List for Captured today (Created Date is today) to spot new tasks during your daily review.

Asking Siri to Work with Your Tasks

Requires macOS 27 or later

On earlier versions, use the spoken phrases above and your own named Shortcuts.

On macOS 27, your 2Do tasks and lists are available to Siri directly, so you can talk through a change in your own words rather than building a shortcut for it first. Siri can:

• Create a task with a title, a destination list, notes, a due date and time, a star, tags, one URL, and a repeat.
• Update a task: change its title, notes, due date and time, star, tags, URL, or repeat, or move it to another list. Anything you do not mention stays as it is.
• Complete a task, or mark a completed task as not done.
• Delete one or more tasks.
• Find tasks, lists, and list groups by name.

Tasks created this way are always plain tasks. Siri does not create projects or checklists, and it does not set a priority, start date, duration, alarms, sub-tasks, or locations. Create those in the app or with 2Do's Shortcuts actions.

Siri works with your normal lists and list groups, picking from the ones you already have. It does not create lists, and Smart Lists are not offered. A repeat that does not map onto 2Do's own repeat rules is refused rather than approximated.

Creating, updating, and deleting through Siri follow the same security rules as the rest of 2Do's automation: they require device authentication, and while an app password is set under Settings > Security, 2Do keeps its data away from Siri and Shortcuts entirely. See Password Protection.

This is a separate surface from the Shortcuts app. It adds no actions there, and the shortcuts you have already built keep working as they are. See Automate with Shortcuts for the full catalogue.

Naming Lists for Siri

If your shortcut sends tasks to a specific 2Do list, use the list name exactly as it appears in 2Do. Avoid names that conflict with date words such as Today or Tomorrow when speaking to Siri, because Siri may treat those words as dates rather than list names.

URL-Scheme Flows

For callback-style integrations, or for driving 2Do from apps that only know how to open URLs, the twodo:// scheme remains fully supported. A clipboard-capture example:

1. Get Clipboard.
2. URL Encode the result.
3. Open URL with twodo://x-callback-url/add?task=<encoded>&forlist=Inbox.

See URL Schemes for the full action and parameter reference.

tip

Use usequickentry=1 in your URL if you want the flow to show Quick Entry before saving. Leave it out when you want the task saved immediately. (The native Create Task action always saves directly.)