Skip to main content

Siri and Shortcuts

2Do for Mac plugs into the macOS Shortcuts app with a full set of native actions — create, find, update, complete, move, and delete tasks, no scripting required — and Siri can run any shortcut you build by name. For callback-style integrations there's 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 even sub-task titles), 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.

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 — 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.

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.

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 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.)

Tips​

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.

tip

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

Last updated on