{"_id":"@4ier/notion-cli","_rev":"8-03bad607ee9397e2d3117e7ed71e4a85","name":"@4ier/notion-cli","dist-tags":{"latest":"0.7.0"},"versions":{"0.2.0":{"name":"@4ier/notion-cli","version":"0.2.0","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.2.0","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"35b605b8d89cc3284ba0f6e416868717d9e2ff17","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.2.0.tgz","fileCount":6,"integrity":"sha512-Fevx/EjXA6rgpBkBffEYk6fh8cWWFiux1prlUF/9mNOrNfkHPHGOtBd93TAAiEr6gD5K6tiEKAKUiiieMsvf3A==","signatures":[{"sig":"MEYCIQC9vA0x3HWBz1NByyE5O3T7m/SMFvNRCTNXCpD3XDbCQAIhAJeKAPoJBouY/uGdtZLNnpO5+UAlHxS/BQQYkuK1Q6Ug","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10639},"engines":{"node":">=16"},"gitHead":"50c5e8c8378205840aece3355ad7fd7ad3be8484","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 39 commands, one binary.","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.2.0_1771914990517_0.05617357873812434","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@4ier/notion-cli","version":"0.3.0","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.3.0","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"f583280d7397552a123e6c2c84f905608e918ab7","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.3.0.tgz","fileCount":6,"integrity":"sha512-tbjodojPG63XGyXyUaCRxPHtReSKJCo/Ef+pbCdBxbnQRKe49y/PDwyGDB376XUoKtXgp2yFEA4BdBqwSynrGw==","signatures":[{"sig":"MEUCIQCEIrBZQZzkSwPmMKRAYizLwYu9mLQ8Das2NN2TG4bldwIgGsa0cuJ7FaZqebhXlb1rcRYYzN5gc467szxeNvNosxs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10639},"engines":{"node":">=16"},"gitHead":"50c5e8c8378205840aece3355ad7fd7ad3be8484","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.3.0_1771927357729_0.3842786708615449","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@4ier/notion-cli","version":"0.3.1","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.3.1","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"5892241ba62e30e467dd619dfe6a2f19d6508a5d","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.3.1.tgz","fileCount":6,"integrity":"sha512-UUl9aqcwwaryaOD6ugR5gXByD0WgSVJB8n6604J7bLuQ7qm2ynqCnPGfyo/qgydrFrpB1fvWvh3uizwxfZJRjQ==","signatures":[{"sig":"MEYCIQDGFPgo4UYejPBnTkfkMOEKKbczF6hfjCR9BqYrhE3WdAIhALnNP8vuM2QR9y4tBGcUWww3TBckHSRYDyaLbuas3vBP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11212},"engines":{"node":">=16"},"gitHead":"28dd16a65f6518781b4ec5a7ce0176cd284025b3","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.9.7","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.3.1_1775463801104_0.3353530253631156","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@4ier/notion-cli","version":"0.3.2","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.3.2","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"bcd0c6af0e36e9de81189d2cfc5fc9a1ed48e669","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.3.2.tgz","fileCount":6,"integrity":"sha512-7/3cLV7vYzMk/7t9YP9D9TnGGhfMVBvfakLvbsy8yy3mP8CipJMEc5By5pTLOuLLmg1iwtlQQn2t/dceRZkuyw==","signatures":[{"sig":"MEUCIQDKn7Ij5fKAyzt8p+tpQtoPSeC5VGfP1wWpdUc4BlkZVgIgRU0SLhTCcQ38D66G7A7VR4wCpl/HgtuHsPYdJazCD3o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11525},"engines":{"node":">=16"},"gitHead":"f594e22da492887a09e1541281d8b49e87169203","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.9.7","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.3.2_1775526038886_0.4519547769464405","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@4ier/notion-cli","version":"0.4.0","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.4.0","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"382c49b2db5c4855699cdd8eb6b7151995994fce","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.4.0.tgz","fileCount":6,"integrity":"sha512-nMnwpW4Q1+KXq5PAz54Fwl0edCj5/QEnK5xXL43mclRZffomOwNMfLjfhG8kG3dYGjYaZxK9S5sapmGQslDYqA==","signatures":[{"sig":"MEUCIEF5iE4vBTroRuKJrrSuSoBU88WEc+5ovHmP/qjhsojcAiEAlXnzE4nlBp42FwhRT2CUUH9v5b5LtSm0wkfq6DeHgMs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12256},"engines":{"node":">=16"},"gitHead":"cbbb11b47f326ae94d01f7d65c681641b6be5dcc","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.8.2","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.4.0_1776492944746_0.657699547878366","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@4ier/notion-cli","version":"0.5.0","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.5.0","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"4749c8adbebd99a94008078874a3e117b423f656","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.5.0.tgz","fileCount":6,"integrity":"sha512-5jUKB2qQ+Us7Q6VPqzhi7wPZZLHkyNObvp0f5wCXE3yFs+7Ta20EdiH49lhUmwFWlyQwIpKmj20/wat1k3BExA==","signatures":[{"sig":"MEYCIQDfluUw80NnXcOCLdM6xBys7H20ysP1R+lzCcT0B/08aQIhAP/9rIRF+mv7oftMsZ2iQ0jOCgPop4U0kI9qsZFq2l8q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12695},"engines":{"node":">=16"},"gitHead":"820f13a3bd39fea4f0e770582e15928f80f614ad","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.8.2","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.5.0_1776758322366_0.915348897874144","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@4ier/notion-cli","version":"0.6.0","keywords":["notion","cli","notion-api","database","productivity","agent"],"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","_id":"@4ier/notion-cli@0.6.0","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"homepage":"https://github.com/4ier/notion-cli","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"bin":{"notion":"bin/notion"},"dist":{"shasum":"3551846b971b89e0fa8f50bc6d3fa5e3e138ab36","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.6.0.tgz","fileCount":6,"integrity":"sha512-UOus/YJw+2sXmmuLOMVaBxA/8juU/uIp9kHl/ewgsP7d31DvNyloupNvluK3zxBY52ZrAmw3FHF40KUt2jiLfA==","signatures":[{"sig":"MEUCICd1QTbMLRYrqBy8JoXdvlLfsbh/hbmsT/sUpgM0ZRtUAiEA0srHz+s0M8fervRv41rYFYAYQUXJjUQM/YvDRIuQNsA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12695},"engines":{"node":">=16"},"gitHead":"31726aa8e79e9e855e7f55031cde2f1a800f47ed","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"repository":{"url":"git+https://github.com/4ier/notion-cli.git","type":"git"},"_npmVersion":"10.8.2","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/notion-cli_0.6.0_1777525476216_0.12234256004897093","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@4ier/notion-cli","version":"0.7.0","description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","keywords":["notion","cli","notion-api","database","productivity","agent"],"homepage":"https://github.com/4ier/notion-cli","repository":{"type":"git","url":"git+https://github.com/4ier/notion-cli.git"},"license":"MIT","author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"bin":{"notion":"bin/notion"},"scripts":{"postinstall":"node install.js"},"engines":{"node":">=16"},"_id":"@4ier/notion-cli@0.7.0","gitHead":"93f53dbf41c12e7ff4f7a6b8805ced12d4a071ce","bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-MBgLyEfyOF1Duwfd0OFbrMjh5N+NfEmthJCwac8t3V3QMFAoWN+sjGdDzrJoe/mTgaUc7vmQrT9vK4hLQ27TLQ==","shasum":"07c60ce1e100f8cd08207986d8d3a9f104ba284c","tarball":"https://registry.npmjs.org/@4ier/notion-cli/-/notion-cli-0.7.0.tgz","fileCount":6,"unpackedSize":12695,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHlkv4HSk4lUralQSN5QYGIscCD8N7TSO00YalO4Gt0kAiEAt/o/l8xeR53MHl0kzIl6a5fakRw1bKh0SEjr6GasbXg="}]},"_npmUser":{"name":"4ier","email":"yang.fourier@gmail.com"},"directories":{},"maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/notion-cli_0.7.0_1777529781695_0.08160949592337241"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-24T06:36:30.389Z","modified":"2026-04-30T06:16:22.028Z","0.2.0":"2026-02-24T06:36:30.661Z","0.3.0":"2026-02-24T10:02:37.875Z","0.3.1":"2026-04-06T08:23:21.250Z","0.3.2":"2026-04-07T01:40:39.051Z","0.4.0":"2026-04-18T06:15:44.926Z","0.5.0":"2026-04-21T07:58:42.488Z","0.6.0":"2026-04-30T05:04:36.370Z","0.7.0":"2026-04-30T06:16:21.923Z"},"bugs":{"url":"https://github.com/4ier/notion-cli/issues"},"author":{"name":"Fourier","email":"yang.fourier@gmail.com"},"license":"MIT","homepage":"https://github.com/4ier/notion-cli","keywords":["notion","cli","notion-api","database","productivity","agent"],"repository":{"type":"git","url":"git+https://github.com/4ier/notion-cli.git"},"description":"Full-featured CLI for Notion. Like gh for GitHub, but for Notion. 44 commands, one binary.","maintainers":[{"name":"4ier","email":"yang.fourier@gmail.com"}],"readme":"

\n notion-cli\n

\n\n

\n Like gh for GitHub, but for Notion. 39 commands. One binary.\n

\n\n

\n \"demo\"\n

\n\n

\n \"Release\"\n \"Tests\"\n \"License\"\n \"Go\n

\n\n---\n\nA full-featured command-line interface for [Notion](https://notion.so). Manage pages, databases, blocks, comments, users, and files — all from your terminal. Built for developers and AI agents who need programmatic access without the browser.\n\n## Install\n\n### Homebrew (macOS/Linux)\n```sh\nbrew install 4ier/tap/notion-cli\n```\n\n### Go\n```sh\ngo install github.com/4ier/notion-cli@latest\n```\n\n### npm\n```sh\nnpm install -g @4ier/notion-cli\n```\n\n### Scoop (Windows)\n```powershell\nscoop bucket add 4ier https://github.com/4ier/scoop-bucket\nscoop install notion-cli\n```\n\n### Docker\n```sh\ndocker run --rm -e NOTION_TOKEN ghcr.io/4ier/notion-cli search \"meeting\"\n```\n\n### Binary\n\nDownload from [GitHub Releases](https://github.com/4ier/notion-cli/releases) — available for Linux, macOS, and Windows (amd64/arm64).\n\n## Quick Start\n\n```sh\n# Authenticate\necho \"ntn_xxxxx\" | notion auth login --with-token\n\n# Search your workspace\nnotion search \"meeting notes\"\n\n# Query a database with filters\nnotion db query --filter 'Status=Done' --sort 'Date:desc'\n\n# Create a page in a database\nnotion page create --db \"Name=Weekly Review\" \"Status=Todo\"\n\n# Read page content as Markdown\nnotion block list --depth 3 --md\n\n# Append blocks from a Markdown file\nnotion block append --file notes.md\n\n# Raw API escape hatch\nnotion api GET /v1/users/me\n```\n\n## Commands\n\n| Group | Commands | Description |\n|-------|----------|-------------|\n| **auth** | `login` `logout` `status` `switch` `doctor` | Authentication & diagnostics |\n| **search** | `search` | Search pages and databases |\n| **page** | `view` `list` `create` `delete` `restore` `move` `open` `set` `props` `link` `unlink` | Full page lifecycle |\n| **db** | `list` `view` `query` `create` `update` `add` `add-bulk` `open` | Database CRUD + query |\n| **block** | `list` `get` `append` `insert` `update` `delete` | Content block operations |\n| **comment** | `list` `add` `get` | Discussion threads |\n| **user** | `me` `list` `get` | Workspace members |\n| **file** | `list` `upload` | File management |\n| **api** | ` ` | Raw API escape hatch |\n\n**39 subcommands** covering 100% of the Notion API.\n\n## Features\n\n### Human-Friendly Filters\nNo JSON needed for 90% of queries:\n```sh\nnotion db query --filter 'Status=Done' --filter 'Priority=High' --sort 'Date:desc'\n```\n\nFor complex queries (OR, nesting), use the JSON escape hatch:\n```sh\nnotion db query --filter-json '{\"or\":[{\"property\":\"Status\",\"status\":{\"equals\":\"Done\"}},{\"property\":\"Status\",\"status\":{\"equals\":\"Cancelled\"}}]}'\n```\n\n### Schema-Aware Properties\nProperty types are auto-detected from the database schema:\n```sh\nnotion page create --db \"Name=Sprint Review\" \"Date=2026-03-01\" \"Points=8\" \"Done=true\"\n```\n\n### Smart Output\n- **Terminal**: Colored tables, formatted text\n- **Pipe/Script**: Clean JSON for `jq`, scripts, and AI agents\n```sh\n# Pretty table in terminal\nnotion db query \n\n# JSON when piped\nnotion db query | jq '.results[].properties.Name'\n```\n\n### Markdown I/O\n```sh\n# Read blocks as Markdown\nnotion block list --md --depth 3\n\n# Write Markdown to Notion\nnotion block append --file document.md\n```\nSupports headings, bullets, numbered lists, todos, quotes, code blocks, and dividers.\n\n### External Images\nInsert or append an image block by URL (no upload — points to externally hosted image):\n```sh\n# Insert after a specific block (e.g. next to a \"TODO: add figure\" placeholder)\nnotion block insert --after \\\n --image-url https://example.com/diagram.png \\\n --caption \"Figure 1 — architecture\"\n\n# Append to end of page\nnotion block append --image-url https://example.com/diagram.png\n```\n\n### Recursive Block Reading\n```sh\nnotion block list --depth 5 --all\n```\n\n### URL or ID — Your Choice\n```sh\n# Both work\nnotion page view abc123def\nnotion page view https://notion.so/My-Page-abc123def456\n```\n\n### Actionable Error Messages\n```\nobject_not_found: Could not find page with ID abc123\n → Check the ID is correct and the page/database is shared with your integration\n```\n\n## For AI Agents\n\nThis CLI is designed to be agent-friendly:\n- **JSON output** when piped — no parsing needed\n- **Schema-aware** — agents don't need to know property types\n- **URL resolution** — paste Notion URLs directly\n- **Single binary** — no runtime dependencies\n- **Exit codes** — 0 for success, non-zero for errors\n\nInstall as an agent skill:\n```sh\nnpx skills add 4ier/notion-cli\n```\n\n## Configuration\n\n```sh\n# Token is stored in ~/.config/notion-cli/config.json (mode 0600)\necho \"ntn_xxxxx\" | notion auth login --with-token\n\n# Or use environment variable\nexport NOTION_TOKEN=ntn_xxxxx\n\n# Check authentication\nnotion auth status\nnotion auth doctor\n```\n\n## Troubleshooting\n\n### Windows: MSYS / Git Bash path mangling\n\nIn MSYS-based shells (Git Bash, MSYS2), arguments starting with `/` are silently rewritten to Windows paths. This breaks API path arguments:\n\n```sh\n# ✗ /v1/users/me becomes C:/Program Files/Git/v1/users/me\nnotion api GET /v1/users/me\n```\n\n**Fix:** disable MSYS path conversion:\n\n```sh\nMSYS_NO_PATHCONV=1 notion api GET /v1/users/me\n```\n\nOr export it for the session: `export MSYS_NO_PATHCONV=1`\n\n> This is a shell-level issue, not a bug in notion-cli. PowerShell and cmd.exe are not affected.\n\n## Contributing\n\nIssues and PRs welcome at [github.com/4ier/notion-cli](https://github.com/4ier/notion-cli).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}