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
Decision gist · record as of 2026-07-27
Notion skill lets you automate Notion pages and databases via curl commands and the Notion API. 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.
Use it when
- 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.
- Yes, Notion's database query endpoint accepts POST requests to /v1/databases/{id}/query with filter and sort parameters.
Verify before relying
Read SKILL.md below before installing (2 files). Open directory: indexed for reading, not audited.
Install
moltis-org/moltis/notion · repository language: Rust
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
File tree — 2 files
crates/skills/src/assets/productivity/notion/SKILL.md
crates/skills/src/assets/productivity/notion/references/block-types.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Automate Notion page and database operations via curl and API”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Control Notion directly from your terminal using curl and the Notion API. Create pages and databases, query data sources with filters and sorts, update properties, and add content to blocks—all without leaving the command line.
This skill exposes the Notion API to read and write pages, databases (called data sources in the latest API version), and blocks. Set up authentication with your integration key, then search, create, update, and query your Notion workspace programmatically.
Work with Notion workspaces programmatically using REST calls. This skill covers authentication setup, all major endpoints for pages and databases, request formatting, rate limits, and best practices for safe data operations.
Notion Automation streamlines database operations through intelligent triggers and multi-platform connections. Build workflows that sync form submissions to databases, generate digests, capture tasks from Slack, and coordinate with calendars—all without manual data entry.
This skill connects to Trello's REST API to automate your board workflows. Create and move cards, manage lists, add comments, and archive items—all via curl commands authenticated with your API key and token.
This skill connects your Notion workspace to external workflows using the Notion REST API. Search and retrieve pages, read full content, append blocks, query databases with filters, and create new entries—all authenticated through OAuth. Perfect for syncing Notion data with other tools and automating workspace updates.
More skills notion (MIT) · notion (MIT)