notion

Create, read, update, and query Notion pages and databases via curl.

228k|44.7k|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/NousResearch/hermes-agent --skill notion-nousresearch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/NousResearch/hermes-agent --skill notion-nousresearch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to interact with your Notion workspace directly from the terminal using simple curl commands, eliminating the need for dedicated Notion clients or complex SDKs for common tasks.

Core Features & Use Cases

  • Create and Manage Pages: Generate new pages, add content, and update existing ones.
  • Database Operations: Search, create, query, and update entries within Notion databases.
  • Use Case: Quickly add a new task to your "Project Tracker" database with a specific status and due date, or search for a specific page title without leaving your command line.

Quick Start

Use the notion skill to create a new page in your "My Tasks" database with the title "Follow up with client".

Frequently Asked Questions about notion

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

FAQPage Schema
How do I manage Notion pages and databases using curl?

You can manage Notion pages and databases using curl by sending direct HTTP requests to the Notion API. This approach requires a valid Notion API key and specific API version headers to authenticate and execute operations like creating, reading, or updating data.

Can I query a Notion database from the command line without an SDK?

Yes, you can query a Notion database from the command line using curl. By structuring your curl command with the appropriate Notion API endpoint and authentication headers, you can retrieve and search existing database entries without needing dedicated SDKs or clients.

Do I need a dedicated Notion client to create new database entries?

No, you do not need a dedicated Notion client to create new database entries. You can use curl commands to directly access the Notion API, allowing you to add new pages and populate database properties like status and due date straight from your terminal.

What is the best way to search for a specific page title in Notion via terminal?

The best way to search for a specific page title in Notion via terminal is using curl to call the Notion API search endpoint. This method allows you to query your workspace directly and retrieve matching page data without leaving the command line interface.

Why does my curl request to the Notion API fail?

Your curl request to the Notion API may fail if it lacks the required authentication credentials. Successful interaction with the Notion API strictly requires including a valid Notion API key and specific Notion API version headers in your curl command.

Does the Notion API support adding content to existing pages via curl?

Yes, the Notion API supports adding content to existing pages via curl. You can use curl commands to update existing pages and append new content blocks, enabling direct content management through simple command-line operations.