⚠️ This project is still in work in progress, please forgive any little flaw here and there.

Notion CLI List Manager ?

A simple command-line tool for managing Notion List databases. ✨

Increase your productivity with a simple command. ?

? Features:

  • fast and clear; saving your idea is as simple as type add "get money" ?‍♂️
  • tables are pretty-printed with fab ASCII tables ?
  • parameters are going to be supported ?

? Get Started:

  • Create a new internal api integration here.
  • Share the default database you want to use with your integration.
    You can copy my free simple template.
  • Download the tool: 1
    pip install notion-cli-list-manager
  • Set the token and your default database id:
    list set --token [token] --id [database-id]
  • You’re done!

? Syntax:

TL;DR: list is the keyword for activate this tool from the terminal. Typing just list, the list of your default database’s items will be shown. Other commands can be use typing list [command]

Commands: Args and options:
list to display all the List items not done yet 2. --db [id] to display a specific database. Otherwise the default database will be shown.
--all to display all the lists.
list add [title] to add a new List item called title. [title] will be the text of the List item (and the title of the associated Notion database page)
--db [id] to add the entry to a specific database. Otherwise, the default database will be used.
list rm [index] to remove the List item with the index index.
(Command to call after list)
[index] has to be formatted either like a range or a list, or a combination of these. E.g.: 3,4,6:10:2 will remove pages 3, 4, 6, 8.
list db to display all the notion display saved in the manager. --label [LABEL] --id [ID] to add a database to the manager.
--rm [LABEL] to remove a database named [LABEL] from the manager. Note that adding or removing a database to the manager does not cause the actual creation or deletion on Notion.
list set --token [token] --id [database_id] to set the token and the ID of the Notion Database you want as default. This must be executed as the first command. You can get the [token] as internal api integration here.
You can get the database id from the database url: notion.so/[username]/[database_id]?v=[view_id].

? Still to do:

See the project tab for a complete and real-time-updated list.
Issues and PRs are appreciated. ?

Footnotes

  1. You can also clone the repo to have always the very last version.
    Having installed Python3 and Pip3 on your machine, write on the terminal:
    git clone https://github.com/jacksalici/notion-cli-list-manager.git notion-cli-list-manager
    pip3 install notion-cli-list-manager/dist/notion-cli-list-manager-[last-version].tar.gz

  2. Properties (like the done check option) will be supported soon.

GitHub

View Github