notion-with-api

Search, read, create, and update Notion pages and databases via API.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill notion-with-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-with-api
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/shared-utils/skills/notion-with-api
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill notion-with-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

Notion users need reliable programmatic access to manage pages and databases across workspaces, automate routine tasks, and sync information with external tools.

Core Features & Use Cases

  • Verify token and connect to Notion workspace
  • Search content, read pages, and query databases
  • Create pages under pages or databases and update existing content
  • Create database items with structured properties and optional rich content from markdown

Quick Start

Authenticate with Notion by providing the Internal Integration Secret and workspace, then run the CLI commands to search, read, create, or update pages and databases.

Frequently Asked Questions about notion-with-api

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

FAQPage Schema
How do I manage Notion pages and databases from the command line?

Manage Notion pages and databases from the command line by running CLI scripts that authenticate with the Notion API. This enables programmatic access to search content, read database schemas, and create or update pages directly.

What do I need to connect to the Notion API via CLI?

To connect to the Notion API, you need a Notion Internal Integration Secret, a workspace name, and a Notion version. These credentials are loaded from a .env file or your system environment to verify your token and establish the connection.

Can I create database items with structured properties in Notion programmatically?

Yes, you can create database items with structured properties programmatically. The Notion API operations support creating pages under existing pages or databases, with optional rich content generated from Markdown input via CLI scripts.

How does the Notion API handle content updates from Markdown?

The Notion API handles content updates from Markdown by processing it through CLI scripts. These scripts update existing page content programmatically, converting Markdown into rich text blocks within your connected Notion workspace.

What's the best way to search and read Notion content across workspaces?

The best way to search and read Notion content across workspaces is using API operations that query databases and read pages programmatically. This method provides reliable access to search content and sync information with external tools via CLI automation.