notion-cliNotion CLI for creating and managing pages, databases, and blocks.
Install via ClawdBot CLI:
clawdbot install willykinfoussia/notion-cliUse notion-cli to create/read/update pages, data sources (databases), and blocks.
npm install -g @iansinnott/notion-climkdir -p ~/.config/notionecho "ntn_your_key_here" > ~/.config/notion/api_keyAll commands require the NOTION_TOKEN environment variable to be set:
```bash
export NOTION_TOKEN=$(cat ~/.config/notion/api_key)
```
notion-cli search --query "page title"
notion-cli page retrieve
notion-cli page retrieve
```bash
curl -X POST https://api.notion.com/v1/pages \
-H "Authorization: Bearer $NOTION_TOKEN" \
-H "Content-Type: application/json" \
-H "Notion-Version: 2025-09-03" \
--data '{
"parent": { "database_id": "YOUR_DATABASE_ID" },
"properties": {
"Name": {
"title": [
{
"text": {
"content": "Nouvelle idée"
}
}
]
}
}
}'
```
notion-cli db query
```bash
curl -X PATCH https://api.notion.com/v1/pages/PAGE_ID \
-H "Authorization: Bearer $NOTION_TOKEN" \
-H "Content-Type: application/json" \
-H "Notion-Version: 2025-09-03" \
--data '{
"properties": {
"Name": {
"title": [
{
"text": {
"content": "Nouveau titre"
}
}
]
},
"Status": {
"status": {
"name": "In progress"
}
},
"Priority": {
"select": {
"name": "High"
}
},
"Due date": {
"date": {
"start": "2026-02-10"
}
},
"Description": {
"rich_text": [
{
"text": {
"content": "Description mise à jour"
}
}
]
}
}
}'
```
notion-cli db retrieve
Common property formats for database items:
{"title": [{"text": {"content": "..."}}]}{"rich_text": [{"text": {"content": "..."}}]}{"status": {"name": "Option"}}{"select": {"name": "Option"}}{"multi_select": [{"name": "A"}, {"name": "B"}]}{"date": {"start": "2024-01-15", "end": "2024-01-16"}}{"checkbox": true}{"number": 42}{"url": "https://..."}{"email": "a@b.com"} notion-cli search --query "AIStories"
```bash
notion-cli db query 2faf172c094981d3bbcbe0f115457cda \
-a '{
"property": "Status",
"status": { "equals": "Backlog" }
}'
```
notion-cli page retrieve 2fdf172c-0949-80dd-b83b-c1df0410d91b -r
```bash
curl -X PATCH https://api.notion.com/v1/pages/2fdf172c-0949-80dd-b83b-c1df0410d91b \
-H "Authorization: Bearer $NOTION_TOKEN" \
-H "Content-Type: application/json" \
-H "Notion-Version: 2025-09-03" \
--data '{
"properties": {
"Status": {
"status": {
"name": "In progress"
}
}
}
}'
```
notion-cli db query without arguments to enter interactive mode--raw flag for complete API responses-a flag for complex filters with AND/OR conditionsnotion-cli help for complete command referenceGenerated Mar 1, 2026
Digital agencies can use this skill to automate content planning and tracking. It allows teams to search for existing pages, create new content entries in databases, and update statuses as projects move through stages like drafting, review, and publishing, streamlining collaboration across remote teams.
Startups can leverage this skill to manage tasks and projects within Notion databases. Users can query databases to filter tasks by status (e.g., backlog, in progress), update priorities and due dates, and retrieve page content for detailed updates, enhancing productivity in fast-paced environments.
Academics and researchers can use this skill to organize research notes and sources in Notion. It enables searching for pages, creating new entries with properties like title and description, and querying databases to filter by topics or status, facilitating systematic literature reviews and data collection.
Small businesses can implement this skill to manage customer interactions and leads in Notion. It supports creating new customer pages in databases, updating properties such as status and priority, and querying to track active leads, helping sales teams stay organized without complex CRM software.
Nonprofits can utilize this skill to plan and coordinate events using Notion databases. Users can search for event pages, update details like dates and descriptions, and query to filter by status (e.g., upcoming, completed), ensuring smooth logistics and volunteer management for community initiatives.
Offer a service that integrates this skill with other tools like Slack or Trello for automated Notion updates. Businesses pay a subscription fee for setup, maintenance, and custom workflows, generating recurring revenue from clients seeking streamlined data synchronization.
Provide consulting services to help organizations implement and optimize Notion workflows using this skill. Revenue comes from one-time project fees or ongoing training sessions, targeting teams that need expertise in automation and database management to improve efficiency.
Develop a user-friendly interface or wrapper around this skill with basic features free and advanced capabilities like bulk updates or analytics behind a paywall. Monetize through tiered pricing, attracting individual users and upselling to teams for enhanced functionality.
💬 Integration Tip
Ensure the NOTION_TOKEN is securely stored and shared only with authorized integrations; use environment variables in scripts to avoid hardcoding keys, and regularly update the Notion API version in headers for compatibility.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.