Notion CLI for creating and managing pages, databases, and blocks.
Use 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:
export NOTION_TOKEN=$(cat ~/.config/notion/api_key)
Search for pages and data sources:
notion-cli search --query "page title"
Get page:
notion-cli page retrieve <PAGE_ID>
Get page content (blocks):
notion-cli page retrieve <PAGE_ID> -r
Create page in a database:
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"
}
}
]
}
}
}'
Query a database:
notion-cli db query <DB_ID> -a '{"property":"Status","status":{"equals":"Active"}}'
Update page properties:
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"
}
}
]
}
}
}'
Get database info:
notion-cli db retrieve <DB_ID>
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": "[email protected]"}Search for pages:
notion-cli search --query "AIStories"
Query database with filter:
notion-cli db query 2faf172c094981d3bbcbe0f115457cda \
-a '{
"property": "Status",
"status": { "equals": "Backlog" }
}'
Retrieve page content:
notion-cli page retrieve 2fdf172c-0949-80dd-b83b-c1df0410d91b -r
Update page status:
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 <DB_ID> 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 reference