Command line Notion task management
A command line app that lets you interact with a Notion task board through Notion's API.
This app requires some setup in Notion before use.
- Visit https://www.notion.so/my-integrations and click Create new integration
- Give the integration a name and ensure your personal workspace is selected
- Select the following capabilities and click submit
- Copy the internal integration token and give it to the app with the command
notion config token set <TOKEN>
- Ensure you're in the same workspace your integration was linked to
- Click Add a page on the left sidebar
- Click Templates in the newly created page
- Expand the Personal dropdown on thr right side and click โ๏ธ Task List, then Use This Template at the top. You now have a Notion Page and Database setup for use with the cli
- In the new page, click Share at the top right. Then click the textbox, select your integration and click invite.
- Run the command
notion config database list
to list eligible databases for task management. The newly created Database should be listed in the command's output. Copy the ID of the database - Paste the database ID in the following command:
notion config database set <ID>
Now you're all set up! ๐
More details on command usage can be found by running notion tasks <COMMAND> --help
Add a new todo task to the board:
notion tasks add "Adopt five cats" --status todo
List all tasks:
notion tasks list
List all tasks and their IDs:
notion tasks list --with-id
List all in-progress tasks:
notion tasks list --status doing
Mark a task as done by name:
notion tasks done --name "Boil ocean"
Mark a task as done by ID:
notion tasks done 59ad73ec-efbd-4b37-ad53-02c8f3b17c56
Move a task to todo and update it's name:
notion tasks update 59ad73ec-efbd-4b37-ad53-02c8f3b17c56 --to todo --name "Finish civ6 game"