notion
This skill exposes the Notion API through curl, enabling you to programmatically create, retrieve, update, and delete pages, databases, and blocks. Work with properties like titles, dates, selections, and relations using standard HTTP requests authenticated with your Notion API key.
Notion skill lets you automate Notion pages and databases via curl commands and the Notion API.
AI-generated summary based on this skill's SKILL.md
Install
moltis-org/moltis/notion · repository language: Rust
git clone https://github.com/moltis-org/moltis
cp -r moltis/crates/skills/src/assets/productivity/notion ~/.claude/skills/notionFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What notion API curl commands can I use to automate tasks?
Notion exposes REST endpoints you can call via curl with your API key. Common commands include creating pages with POST to /v1/pages, querying databases with POST to /v1/databases/{id}/query, updating page properties with PATCH to /v1/pages/{id}, and retrieving blocks with GET to /v1/blocks/{id}/children. Authenticate all requests using a Bearer token header with your Notion API key.
How do I create pages in Notion via the API?
Notion's API lets you create pages by sending a POST request to the /v1/pages endpoint with a JSON body specifying the parent (database or page ID) and properties. You can set standard properties like title, dates, selections, and relations. Each property type has a specific structure—for example, title uses a rich_text array, dates use a date object with start/end fields, and relations reference other page IDs.
Can I query and filter a Notion database with curl?
Yes, Notion's database query endpoint accepts POST requests to /v1/databases/{id}/query with filter and sort parameters. You can filter by property conditions (equals, contains, date ranges) and sort results by multiple properties in ascending or descending order. The response includes paginated results; use the next_cursor field to retrieve additional pages.
What's required for Notion API key setup in the terminal?
Notion API authentication requires a Bearer token obtained from your Notion workspace integration settings. Store this token securely and pass it in the Authorization header of every curl request as 'Authorization: Bearer YOUR_TOKEN'. You'll also need the IDs of your databases and pages, which you can find in Notion's URL or retrieve via API calls.
How do I update Notion page properties using curl?
Notion's PATCH endpoint at /v1/pages/{id} allows you to update page properties. Send a JSON body with the properties object containing the fields you want to modify—for example, setting a title, updating a date, or changing a select option. Only include properties you're changing; omitted properties remain unchanged.
What license does Notion skill use?
Notion skill is released under the MIT license, allowing free use, modification, and distribution with minimal restrictions.
SKILL.md
rendered from the published skill — quoted content, verbatim
Notion API
Use the Notion API via curl to create, read, update pages, databases (data sources), and blocks. No extra tools needed — just curl and a Notion API key.
Prerequisites
- Create an integration at https://notion.so/my-integrations
- Copy the API key (starts with
ntn_orsecret_) - Store it in
your environment:NOTION_API_KEY=ntn_your_key_here - Important: Share target pages/databases with your integration in Notion (click "..." → "Connect to" → your integration name)
API Basics
All requests use this pattern:
curl -s -X GET "https://api.notion.com/v1/..." \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json"
The Notion-Version header is required. This skill uses 2025-09-03 (latest). In this version, databases are called "data sources" in the API.
Common
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
crates/skills/src/assets/productivity/notion/SKILL.md
crates/skills/src/assets/productivity/notion/references/block-types.md