{"id":13658135,"url":"https://github.com/jacksalici/notion-cli-list-manager","last_synced_at":"2025-10-15T00:48:54.520Z","repository":{"id":45234981,"uuid":"439910643","full_name":"jacksalici/notion-cli-list-manager","owner":"jacksalici","description":"A simple command-line tool for managing Notion databases.","archived":false,"fork":false,"pushed_at":"2022-01-05T15:38:27.000Z","size":8676,"stargazers_count":98,"open_issues_count":3,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-11T22:41:06.545Z","etag":null,"topics":["cli","database","notion","python","todo"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jacksalici.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-19T16:19:31.000Z","updated_at":"2025-04-11T18:12:54.000Z","dependencies_parsed_at":"2022-08-04T13:00:14.500Z","dependency_job_id":null,"html_url":"https://github.com/jacksalici/notion-cli-list-manager","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/jacksalici/notion-cli-list-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksalici%2Fnotion-cli-list-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksalici%2Fnotion-cli-list-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksalici%2Fnotion-cli-list-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksalici%2Fnotion-cli-list-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jacksalici","download_url":"https://codeload.github.com/jacksalici/notion-cli-list-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksalici%2Fnotion-cli-list-manager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259360729,"owners_count":22845817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","database","notion","python","todo"],"created_at":"2024-08-02T05:00:56.666Z","updated_at":"2025-10-15T00:48:49.467Z","avatar_url":"https://github.com/jacksalici.png","language":"Python","funding_links":[],"categories":["Python","HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"\n##### ⚠️ This project is still in work in progress, please forgive any little flaw here and there.\n# Notion CLI List Manager 🗂\nA simple command-line tool for managing [Notion](http://notion.so) ___List___ databases. ✨  \n\n### Increase your productivity with a simple command. 🛋\n\n![](showcase.gif)\n\n## 📺 Features:\n- fast and clear; saving your idea is as simple as type `add \"get money\"` 💆‍♂️\n- tables are pretty-printed with fab ASCII tables 🌈\n- parameters are now supported [^3] 🎻\n\n\n## 👾 Get Started:\n- Create a new internal api integration [here](https://www.notion.so/my-integrations).\n- ❗️ Share the default database you want to use with your integration.  \n  You can copy [my free simple template](https://jacksalici.notion.site/d75c9590dc8b4d62a6c65cbf3fdd1dfb?v=0e3782222f014d7bb3e44a87376e3cfb).\n- Download the tool: [^1]\n```\n    pip install notion-cli-list-manager\n```\n- Set the token and your default database id:\n```\n    list set --token [token] --id [database-id]\n``` \n- You're done!\n\n## 🧰 Syntax:\nTL;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]`\n\n| Commands:|    | Args and options:|\n|---|---|---|\n| `list` | to display all the ___List___ items. | `--db [id] ` to display a specific database. Otherwise the default database will be shown.\u003cbr\u003e `--all` to display all the lists.\n| `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)  \u003cbr\u003e `--db [id] ` to add the entry to a specific database. Otherwise, the default database will be used.| \n| `list rm [index]` | to remove the ___List___ item with the index `index`.  \u003cbr\u003e _(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.\n| `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.\u003cbr\u003e `--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. \u003cbr\u003e `--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].\n| `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](https://www.notion.so/my-integrations). \u003cbr\u003e You can get the database id from the database url: notion.so/[username]/`[database_id]`?v=[view_id]. \u003cbr\u003e 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.   |\n\n## 🛒 Still to do:\nSee the [project tab](https://github.com/jacksalici/notion-cli-list-manager/projects/1) for a complete and real-time-updated list.    \nIssues and PRs are appreciated. 🤝\n\n\n[^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.\n\n[^1]: You can also clone the repo to have always the very last version.  \nHaving installed Python3 and Pip3 on your machine, write on the terminal:  \n`git clone https://github.com/jacksalici/notion-cli-list-manager.git notion-cli-list-manager`  \n`pip3 install notion-cli-list-manager/dist/notion-cli-list-manager-[last-version].tar.gz`\n\n\n\n\n    \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacksalici%2Fnotion-cli-list-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjacksalici%2Fnotion-cli-list-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacksalici%2Fnotion-cli-list-manager/lists"}