Skip to content

Latest commit

 

History

History
69 lines (46 loc) · 2.3 KB

readme-tw-notion.md

File metadata and controls

69 lines (46 loc) · 2.3 KB
Raw

Taskwarrior ⬄ Notion

Description

Synchronize all the to_do blocks of a Notion page with a filter in Taskwarrior. The Taskwarrior filter may be a task, a project or a combination of a project and arbitrary tags.

Upon execution, tw_notion_sync will synchronize, and on subsequent runs of the program keep synchronized, the following attributes:

  • Plaintext description of the to_do block <-> TW task title
  • Whether it's checked ✅ or unchecked <-> TW task completion status
  • to_do block is deleted / archived <-> TW task deletion

Usage example

To synchronize the "to_do" blocks of a notion page with a tag called "test" you can use something like:

tw_notion_sync -n <page-uuid-grabbed-from-page-url> -t test

Demo

tw-notion-demo

Installation

Package Installation

Install the syncall package from PyPI, enabling the notion and tw extras:

pip3 install syncall[notion,tw]

Create a notion application

After installing the python package, you have to create an app at notion. This a mandatory step for now since I have not made this an official Notion integration.

Navigate to your Integrations create a new application and copy the API token. The name of the application does not matter.

You now have to explicitly give access to any page you want the newly created application to use. After that, you can fetch the UUID of the page you want to sync from the URL and paste it when running the tw_notion_sync script.

Reading the notion application token

There are two ways tw_notion_sync can read the aforementioned API token:

  • Via the NOTION_API_KEY environment variable or,

  • Via the UNIX Password Manager. You can specify the path in the Pass manager to read the encrypted token from. The default path is notion.so/dev/integration/taskwarrior/token under the password store.

    The latter will run gpg on the background and assumes that you are using a gpg-agent, otherwise it will ask you for your GPG password.

See also