Add Todos from Your Phone with the iOS Shortcut · Alpen Planner
Back to Blog

Integrations

Add Todos from Your Phone with the iOS Shortcut

ios shortcuts siri mobile api

Capture Ideas Anywhere

A core tenant of the Alpen approach is that you capture ideas anywhere, anytime, and quickly. Within the web app you can press Space on esentially every screen to add a Quick Todo (a todo that goes to your Unplanned track).

Not everything waits for you to be in front of your computer and I find that a lot of the boring administrative tasks will be forgotten by the time you sit back down in front of your workstation. The Alpen iOS shortcut lets you add a todo to your Unplanned track directly from your phone through a widget or hands-free by asking Siri. It’s a quick bridge until a native mobile app arrives.


Step 1: Generate an API Token

The shortcut authenticates with your Alpen account using an API token which you’ll need to generate within the Alpen web app.

  1. Open Alpen and go to Settings. (https://alpenplanner.com/settings)
  2. Scroll to the API Tokens section.
  3. Click Generate API Token.
  4. Copy the token — you’ll need it in the next step.

Alpen Settings page showing the API Tokens section with a Generate API Token button

Keep your token private. Anyone with it can read and write to your account. Make sure you store it safely

Since we won’t show the full token to you. You’ll need to create a new one if you forget it and revoke the old one.


Step 2: Install the Shortcut

Tap the link below on your iPhone or iPad to add the shortcut to the Shortcuts app:

Add to Shortcuts →

You’ll see the Add Alpen shortcut appear. Tap Set Up Shortcut to continue.

iOS screen showing the Add Alpen shortcut with a Set Up Shortcut button


Step 3: Enter Your API Token

To make things obvious the shortcut will request the api token from you each time it runs. Obviously this isn’t what we want so at this point we’ll come in to remove the ‘Ask Each Time’ option and replace it with our token.

  1. Tap the Ask Each Time field next to Authorization: Bearer.
  2. Paste the token you copied from Settings.
  3. Tap Done.

Configure This Shortcut screen showing the Authorization Bearer token field

When you run the shortcut for the first time, iOS will ask permission to connect to the internet. In my case since I use DuckDuckGo it asks for permission through that. Tap Allow.

iOS Privacy prompt asking to allow Add Alpen to connect to the internet


Step 4: Add to Your Home Screen (Optional)

Once installed, the shortcut appears in your All Shortcuts list. You can run it from there anytime.

All Shortcuts list showing the Add Alpen shortcut at the top

For even quicker access, I recommend adding it somewhere in the homescreen. I prefer using voice through Siri to add something but if I’m in an area where I can’t speak I can still add a todo by typing things in as we’ll see. To add it to your home screen. Open the shortcut details, go to the Details tab, and tap Add to Home Screen.

Shortcut Details screen with an arrow pointing to the Add to Home Screen option


Using the Shortcut

From the Shortcuts app or home screen:

Tap the shortcut, type your todo name, and tap Done.

iOS prompt asking "What's the name for the todo?" with "Do a set of laundry" typed in

With Siri:

Say “Hey Siri, add Alpen” and Siri will ask you for the todo name. Dictate it and it’s done — no tapping required.


Where Todos Land

Every todo created by the shortcut goes straight into your Unplanned track. You’ll see it waiting in Alpen through the red notification badge to the left. You can click on the notifications badge and you’ll see a list of all the unplanned todos in your account that need to be triaged/categorized. We’ll cover that in a separate article.

Alpen Notifications screen showing "Do a set of laundry" in the Recent Unplanned Todos section


Give it a Try

Feel free to try this out to really begin to feel the benefits of the Alpen philosophy. You’ll start to gain trust that those wavering thoughts won’t be lost in the chaos of your day and that your system will be there to catch you. All it takes is a little tap or a shout to Siri.

As always, feedback is always welcome. If an Android user has any suggestions on how to do the same thing on Android, please let us know. We’re always looking for ways to reduce the friction of using adding todos.


Troubleshooting

“Unauthorized” error — Your token may be wrong or revoked. Go to Settings, revoke the old token, generate a new one, and re-enter it when configuring the shortcut.

Shortcut not responding to Siri — Open the Shortcuts app, find Add Alpen, and confirm it’s listed under your shortcuts. Siri should pick it up automatically.