notion-cli

Operates and manages Notion Serverless Functions and their triggers and schedules.

6|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/memoirlabs/mog --skill notion-cli-memoirlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-cli
Source: https://github.com/memoirlabs/mog/tree/main/apps/mog/src/brain/skills/notion-cli
Command: npx skills add https://github.com/memoirlabs/mog --skill notion-cli-memoirlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reliably interact with the Notion API from the command line, so you can query databases, create pages, upload files, and manage workers without guessing request shapes or CLI syntax.

Core Features & Use Cases

  • API discovery and endpoint execution: Use ntn api to list endpoints, show help, print official docs, and view OpenAPI fragments before making calls.
  • File uploads: Use ntn files as a convenience wrapper to create and manage Notion file uploads.
  • Worker lifecycle management: Use ntn workers to deploy, list, execute capabilities, and scaffold worker projects; use ntn tokens to manage worker auth tokens.
  • Use Case: When you need to create a Notion page under a known parent page ID and you want to verify the correct endpoint and body schema, this Skill guides you to the right ntn api pattern.

Quick Start

Use ntn api v1/pages parent[page_id]=abc123 to create a new page under the parent page with ID abc123.

Frequently Asked Questions about notion-cli

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

FAQPage Schema
How do I query Notion databases from the command line?

Query Notion databases from the command line using the `ntn api` command, which allows you to list endpoints, view OpenAPI fragments, and execute API calls. You need a Notion API token to authenticate and run database queries via `ntn api`.

Can I upload files to Notion pages using a CLI?

Yes, you can upload files to Notion pages using the `ntn files` command. It acts as a convenience wrapper to create and manage Notion file uploads directly from your terminal without manual API requests.

How do I create a Notion page under a specific parent page ID?

Create a Notion page under a specific parent ID by running `ntn api v1/pages parent[page_id]=abc123`. This command uses the `ntn` CLI to interact with the Notion API, ensuring the correct endpoint and body schema are applied for page creation.

Do I need a session login to deploy Notion workers?

Yes, deploying Notion workers requires a session login. While `ntn api` and `ntn files` use a standard Notion API token, managing worker lifecycles with `ntn workers` and managing auth with `ntn tokens` requires session-based authentication.

What is the best way to discover correct Notion API endpoint schemas before making calls?

The best way to discover Notion API endpoint schemas is using `ntn api` to show help, print official docs, and view OpenAPI fragments. This ensures you verify correct endpoint methods and body schemas before executing API calls.

Does the ntn CLI support scaffolding new worker projects?

Yes, the `ntn workers` command supports scaffolding new worker projects. It enables full worker lifecycle management, allowing you to deploy, list, execute capabilities, and scaffold projects directly from the command line.