notion

Interact with Notion workspaces via curl and the Notion API.

1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/automatedigital/spark --skill notion-automatedigital
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/automatedigital/spark/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/automatedigital/spark --skill notion-automatedigital

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the need to write custom scripts or use third-party tools to interact with Notion, letting you manage your workspace content entirely from the terminal with just curl and an API key.

Core Features & Use Cases

  • Full Notion API Access: Search, create, update, and query Notion pages, databases (data sources), and blocks directly via curl commands.
  • No Extra Dependencies: Only requires a Notion API key and curl, no additional software or libraries to install.
  • Use Case: A project manager can use this Skill to automatically pull active task statuses from a Notion database for weekly reporting, or create new task pages directly from terminal commands without opening the Notion web app.

Quick Start

Use the notion skill to search your Notion workspace for all pages containing the text "Q4 roadmap" and return their page IDs and last edited timestamps.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I manage Notion workspaces directly from the terminal?

You can manage Notion workspaces from the terminal by executing authenticated Notion API requests using curl. This approach enables searching, creating, updating, and querying pages and databases without requiring custom client code.

Can I query a Notion database using curl without third-party tools?

Yes, you can query a Notion database using curl without third-party tools by including your API key and the mandatory version header. This allows direct programmatic interaction to retrieve data sources and blocks.

Do I need to install extra libraries to interact with the Notion API via curl?

No extra libraries are needed to interact with the Notion API via curl. You only need a valid Notion API key and the curl command-line tool pre-installed to execute authenticated workspace management operations.

What is the best way to automate pulling task statuses from a Notion database?

The best way to automate pulling task statuses from a Notion database is executing curl commands through the Notion API. This terminal-based workflow directly queries data sources for reporting without opening the web app.

Does the Notion API require a specific version header for curl requests?

Yes, the Notion API requires a mandatory version header for all curl requests. Including this header alongside your API key ensures successful execution for core workspace management operations like searching and updating pages.

What are the limitations of managing Notion pages entirely via terminal commands?

Managing Notion pages via terminal commands is limited to text-based API interactions and programmatic data retrieval. It lacks the visual interface of the Notion web app, making manual content formatting and visual block arrangement less intuitive.