All tools
NotionN

by Notion

Create a page

Creates a page under a parent page, or a new row in a data source, with property values and content.

View on GitHub
Updated Sep 27, 2026Available asMCPCLIAPI

Description

To add a row to a database, set the parent to its data source and match the data source's property schema. `notion-create-pages` can create several pages in one call.

create-page.md

Create a page

Creates a page under a parent page, or a new row in a data source, with property values and content.

To add a row to a database, set the parent to its data source and match the data source's property schema. notion-create-pages can create several pages in one call.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "notion": { "url": "https://mcp.notion.com/mcp" } } }

Call the MCP tool notion-create-pages.

Server URL: https://mcp.notion.com/mcp

CLI (official)

Install the command, then confirm it runs.

npm install --global ntn
ntn --version

Run ntn api v1/pages.

Set $NOTION_API_TOKEN in your environment first (get a key: https://www.notion.so/developers/tokens).

API (official)

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
MCPOfficial · remotenotion-create-pagesOAuthDocs
CLIOfficialntn api v1/pagesAPI key in $NOTION_API_TOKENDocs
APIOfficialPOST /v1/pagesAPI key in $NOTION_API_KEYDocs

Workflows using Create a page