My Orgmode compatible iOS Shortcuts Meeting Capture Workflow with Beorg

I use Beorg for capturing and managing tasks on iOS. I’m using Shortcuts to bring calendar entries in as meetings where I can capture notes. Here’s how:

A Quick Note About My Orgmode Setup

Each of the apps that write to my org files usually don’t get allowed to write to my main org files (personal) and (professional). Each app gets its own file named – even Org-capture itself. Thus I have,, (for org-capture), etc.
I do this because different sync mechanisms behave better than others and sometimes I work off-line. Once captured, I will then refile them when I am in Emacs on my Mac.
If Beorg gets out of sync, then the files are appended with a number to keep data from being overwritten. I think with the way iOS works there is no way around this.

Setup Calendar

You need some calendar entries for this to be useful. The Shortcut needs to use the native iOS calendar service. Maybe this Shortcut can be modified to work with other calendars.

Setup Beorg

First, install Beorg. While you can use Dropbox or WebDAV for your sync service I am using iCloud.
Make sure your org-states are defined in the app settings including MEETING as a Done state. Do not enable any calendars in the settings.

Setup Shortcuts

Install Shortcuts if you don’t already have it. If it is a new install, go ahead and launch it to see the introductory stuff.
My shortcut is here. Click on the link while browsing this page from your iOS device. Select install.
You now have the bare minimum for this to work, so run a test. The Shortcut allows you to select multiple calendar entries. Pick just one, select beorg in the share sheet, and make sure you change the state to MEETING. Beorg should open and your meeting should be in the calendar.

Setup macOS

Make sure iCloud is set up. Once it is, create a symlink in your home directory (after making sure there is nothing already using ~/org).
Create a symlink to your beorg document store:

ln -s ${HOME}/Library/Mobile Documents/iCloud~com~appsonthemove~beorg/Documents/org ${HOME}/org

After that, copy all of your Orgmode files from the old locale into ${HOME}/org. This needs to be your master Orgmode location.
P.s. – if you want a command line shortcut to iCloud Documents, do this:

ln -s ${HOME}/Library/Mobile Documents/com~apple~CloudDocs ${HOME}/iCloud

Setup Emacs and Orgmode

One main thing is to make sure all of your Orgmode file entries point to the ${HOME}/org directory we created as a symlink above. Another thing is to define MEETING as a done state. This way it will show up in your agenda as a meeting and not in your task list.

How I Use It

First thing in the morning I run this to capture all of today’s meetings. When the share sheet opens, select beorg. As above, make sure each entry is set for the MEETING state.
When it is ten minutes to meeting time, I get an alert on my watch from beorg. In the meeting I have all the relevant information (or what’s available in the calendar entry) ready for me to take notes on any of my Apple devices (except the watch).
Important note – if capturing meeting notes in Beorg, make sure you open the entry from Files (along the bottom menu bar) and not from the Agenda
At some point before or after the meeting I refile the entries to the appropriate Orgmode target. Unless I’m using a non-Apple device, I don’t care where the entry is when I’m in the meeting.
Every week I archive the meetings after refiling any remaining open tasks in the Next Actions. Sadly, Beorg cannot see archive files.

Wish List

Some of what I would do differently is out of my hands:

  • Beorg doesn’t yet support tags, for example. This is fixed as of 14 Nov 18.
  • The PROPERTIES don’t fold.
  • If taking meeting notes in Beorg, you have to save regularly and reopen the entry to prevent data loss.
  • It’d be cool on iOS if I could pass the entry to Drafts for the text editing and then pass it back to beorg for writing.
  • I’d also love to be able to attach files from the calendar invite to the entry.
  • Beorg needs to save any open entries before the app sleeps in the background.

I don’t know if the x-callback-url scheme can handle entries as long as some of the calendar events I capture, so I think the share sheet approach is best for now.
UPDATE: The x-callback-URL scheme only supports 2048 total characters, so many meeting invitations will not fit.
Ultimately, it would be great if Beorg did something like this Shortcut for calendar entries when you tap them (when the calendar access is enabled in Beorg’s settings). Unfortunately it takes you to the calendar entry in iOS Calendar.
I would love something for searching Orgmode archive files. Maybe Devonthink-To-Go?


I used to use Dropbox for this. They’ve made some poor decisions about their API and failed to upgrade the free storage amount. Also, many corporate environments block Dropbox. However, a modified version of the above pointing to a folder in Dropbox will work.


This is working for me, though it is far from frictionless. Got ideas on how to improve on my workflow? Send them to me via the indie web.
Update: there is another version without the iOS Share Sheet available here.

2 thoughts on “My Orgmode compatible iOS Shortcuts Meeting Capture Workflow with Beorg

Be nice with what you write.