Skip to main content

A simple command-line tool for managing Notion databases.

Project description

⚠️ 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 now supported [^3] 🎻

👾 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 activating this tool from the terminal. Typing just list, the list of your default database's items will be shown. Other commands can be used typing list [command]

Commands: Args and options:
list to display all the List items. --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. A prompt will then ask you the ordered indexes list.
--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.
--prop [LABEL] to set which and in which order display the properties of an already saved database labeled [LABEL]. A prompt will then ask you the ordered indexes list[^3].
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].
You can also use separately --token and --id to set just one parameter. After the --id command, a prompt will then ask you the ordered indexes list.

🛒 Still to do:

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

[^3]: At the present, properties are fully supported (except Relations and Rolls up that are NS - Not supported) but read-only. Writeable ones will be supported in the next versions.

[^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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notion-cli-list-manager-0.1.6.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

notion_cli_list_manager-0.1.6-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file notion-cli-list-manager-0.1.6.tar.gz.

File metadata

  • Download URL: notion-cli-list-manager-0.1.6.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.8.9 Darwin/21.2.0

File hashes

Hashes for notion-cli-list-manager-0.1.6.tar.gz
Algorithm Hash digest
SHA256 40ec507028f8a65229ebcc117a2eb8cf86ffcf3c1c2e44982446f618b40af899
MD5 f12c5bd1b6bc2115f99ae8fc5962832c
BLAKE2b-256 fb9ad0a62c07eb543fd3e03da454e0805259d5c65a2a7fd8d0b859f44f1f2264

See more details on using hashes here.

File details

Details for the file notion_cli_list_manager-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for notion_cli_list_manager-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 0787276ab509714abdac107f28d0f4f47673285feeb1f7321e75ca0d48e139fd
MD5 76c33752a23c08a6675379284e37e370
BLAKE2b-256 8e9e33a8998ce7299eb51f695689c7df1c68f1a512f4203b87949f4b11142e8a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page