Notion

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.

Notion skill lets you create, query, and manage pages and databases via curl from the terminal.

AI-generated summary based on this skill's SKILL.md

★ 264 ⁮ 22 Apache-2.0 updated 2026-07-26 by graniet

Install

graniet/kheish/notion · repository language: Rust

Manual (git clone) CLI (skillfed)coming soon

git clone https://github.com/graniet/kheish
cp -r kheish/skills/productivity/notion ~/.claude/skills/notion

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I use Notion API with curl?

Notion's API works seamlessly with curl from the terminal. First, set up authentication by including your Notion API key in the Authorization header as a Bearer token. Then use curl commands to make HTTP requests to Notion endpoints—GET requests query pages and databases, POST requests create new content, and PATCH requests update existing properties. Notion provides comprehensive endpoint documentation for all operations.

Can I create a Notion page from the terminal?

Yes, Notion lets you create pages from the terminal using curl and the API. Send a POST request to the pages endpoint with your page's parent database or page ID, title, and properties in JSON format. Include your API key in the Authorization header. You can also add blocks and content in the same request or follow up with additional API calls to populate the page with text, images, and other block types.

How do I query a Notion database via API?

Notion's database query API accepts POST requests with filters, sorts, and pagination parameters. Use the databases/{id}/query endpoint with your database ID. Structure your query in JSON to specify conditions—filter by property values, sort by multiple fields, and paginate through results. The API returns matching pages with all their properties, allowing you to process Notion data directly in scripts and command-line workflows.

What's required to set up Notion API integration?

Notion API integration requires creating an internal integration in your Notion workspace settings to generate an API key. Store this key securely and pass it in curl requests via the Authorization header as a Bearer token. You must also share specific pages or databases with your integration so it has permission to access them. Once configured, you can authenticate all terminal commands and scripts using this key.

How do I manage Notion pages from the command line?

Notion's command-line management uses curl to call the API for page operations. Retrieve page content with GET requests, update properties and add blocks with PATCH requests, and delete pages with DELETE requests. You can automate workflows by chaining curl commands in bash scripts, filtering results with jq, and scheduling tasks with cron. This approach integrates Notion directly into your terminal-based development and automation pipelines.

Can I update Notion page properties via API?

Yes, Notion allows property updates through PATCH requests to the pages endpoint. Specify the page ID and include the properties object with new values in JSON format. You can update text fields, dates, checkboxes, selects, and other property types. The API validates property types and formats, returning the updated page object. This enables automated workflows that modify Notion data based on external events or scheduled tasks.

SKILL.md

rendered from the published skill — quoted content, verbatim

Kheish Compatibility

This skill is repo-local and stays inactive until explicitly activated.

When the original instructions refer to legacy tool names, use these Kheish mappings:

terminal => bash
web_extract => web_fetch, plus web_search when discovery is needed
search_files => grep_search and glob_search
browser_* tools require a browser-capable surfaced tool or MCP; if none is available, use the closest available surface and say so explicitly

When the instructions mention local helper files, resolve them from ${KHEISH_SKILL_DIR}.

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

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 2 files

skills/productivity/notion/SKILL.md
skills/productivity/notion/references/block-types.md

All skills by graniet → Best workplace app skills for AI agents - SkillFed →