skills.rest
jaredcroxton
jaredcroxtonCOMMUNITY
Explore all skills by this author →
GitHub

notion

Read, create, and update Notion pages and databases via CLI or HTTP.

Updated May 16, 2026
Search Tags:#markdown#api#cli#notion#workers#database query#file uploads
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill notion-jaredcroxton
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/productivity/notion
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill notion-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you interact with Notion in reliable, repeatable ways so you can read and write pages, query databases, and build automations without manual clicking.

Core Features & Use Cases

  • Two integration paths (CLI and HTTP): Use the ntn CLI for macOS/Linux and a curl-based HTTP fallback for cross-platform access, including Windows.
  • Agent-friendly read formats: Fetch page content as Markdown for summarization and as blocks when you need structure.
  • Database querying and creation: Query data sources (including typed filters) and create pages/databases with structured properties.
  • Advanced Notion Workers: Scaffold, deploy, and operate Workers (syncs, tools, and webhooks) for scheduled updates and event-driven workflows.

Quick Start

Use this Skill with your Notion integration token to query a database and return the matching items as results: "Query my Notion data source for pages where Status equals Active and sort by Date descending using Notion API version 2025-09-03."

Frequently Asked Questions about notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query a Notion database with typed filters using the API?▼

Query a Notion database by sending a POST request with typed filter objects and sort parameters to the search endpoint, returning matching pages as structured results using Notion API version 2025-09-03.

How do I convert Notion pages to Markdown for summarization?▼

Fetch Notion pages as Markdown using a programmatic read format designed for agent-friendly ingestion, allowing you to extract and summarize page content without manual copying or clicking.

Can I use the Notion API on Windows or do I need a specific CLI?▼

You can use the Notion API on Windows via a curl-based HTTP fallback, while macOS and Linux environments support the native ntn CLI for executing database queries and page updates.

Do I need an integration token to automate Notion database updates?▼

Yes, automating Notion database updates requires a NOTION_API_KEY integration token to authenticate programmatic requests for reading, creating, and updating structured content via API version 2025-09-03.

What is the best way to schedule event-driven workflows with Notion data?▼

Scaffold, deploy, and operate Notion Workers to handle event-driven workflows and scheduled syncs via webhooks, enabling automated updates across your connected tools without manual intervention.

Does the Notion API support file uploads and creating pages with structured properties?▼

Yes, the Notion API supports file upload workflows and allows you to create pages and databases with structured properties programmatically, moving data between Notion pages, data sources, and external tools.

Related Skills

Explore More Software Engineering Skills→
cxnaivecxnaive

notion

Manage Notion pages and databases via the ntn CLI and API.

Community
Advanced
akselikorhonen-siiliakselikorhonen-siili

html-to-md

Extract HTML content from web pages and convert it to Markdown.

Community
Basic
SignmanalSignmanal
1

notion

Automate Notion page, database, and file operations via the Notion API.

Community
Intermediate
ashiqcodeleafashiqcodeleaf

notion

Manage Notion pages and databases via the Notion API and ntn CLI.

Community
Intermediate