Integrating Notion with Alfred

My Notion Workflow in Alfred

Last month I wrote about My Weekly Notion Setup and how I use it to help organize my life.

Click to get my Weekly Notion Template

I like to use tools that are an extension of my hand and mind. If the tool does not bend to my will then I need to tailor it to do so. I’ve done this many times before, to which I normally share the end result (i.e., how I synchronize my dotfiles, adding keyboard navigation to Todoist on MacOS, amongst other examples).

This month, I want to share how I integrate my Notion [Referral] setup with Alfred. At the time of publication, Notion has not yet released an official API. I ended up taking advantage of notion-py – an unofficial Python API client for Notion. With various Python scripts, I was able to connect everything together in an Alfred Workflow (as seen in the post’s title image).

Added Extensions

I mainly wanted to bypass the need for direct interaction with Notion, so that I could avoid excessive context switching. I was able to put together the following actions in Alfred:

  • :week
    • This keyword will open Notion to the current week.
  • :day
    • This keyword will open Notion to the current day.
  • :note
    • This keyword allows me to append a text block at the end of my current day’s notes section.
  • :tag
    • This keyword allows me to create a new tag in my tags database.
  • :win
    • This keyword allows me to create a new win in my wins database.
  • :task
    • This keyword allows me to create a new task in my tasks database.
  • :search
    • This keyword allows me to search my current day’s tasks, and be able to open it in Notion or change its status.

The end result allows me to do stuff like the following:

Watch a video with more detail

Alfred notion demo

How do I get this?

I’ve published the Alfred Workflow and Python scripts in a repository on GitHub at alfred-notion. For the most part, you can follow the instructions laid out in the README.md as it’ll be up to date with new changes.

Click to check out alfred-notion

I like to remind everyone that this is my tailored solution on how I’ve integrated Notion to fit my needs. If you want to use my solution as inspiration or as a foundation, everything is open sourced. If you want to use it verbatim, then don’t forget to get the weekly template.

NOTE: v1.0.0 is current at the time of publication (June 16, 2019).