// SCAN REPORT

Notion Private Api

11 tools. 6 can modify or destroy data without limits.

1 destructive tool with no built-in limits. Policy required.

Last updated: 30 Jun 2026

6 can modify or destroy data

5 read-only

11 tools total

Community server · catalogue entry verified 30/06/2026

How to control Notion Private Api ↓

TOOL MAP

What Notion Private Api exposes to your agents

Read (5) Write / Execute (5) Destructive / Financial (1)

Running more than one server? Check your whole stack →

MOST DANGEROUS TOOLS

Critical Risk

The most dangerous Notion Private Api tools

Destructive · Critical delete_blocks This tool irreversibly deletes data (blocks) from Notion pages. Write · High create_page This tool creates new pages in Notion, which is a reversible write operation. Write · High replace_page_content This tool modifies (replaces) blocks on a page, which is a Write operation. Write · High sync_markdown_file This tool performs reversible data modification operations (create and update).

6 of Notion Private Api's 11 tools can modify, destroy, or commit something on every call — and an agent calls them with no built-in limits.

POLICY

How to control Notion Private Api

PolicyLayer is an MCP gateway — it sits between your AI agents and Notion Private Api, and nothing reaches the server without passing your rules. These are the rules we recommend:

Deny destructive operations

{
  "delete_blocks": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations

{
  "append_blocks": {
    "limits": [
      {
        "counter": "append_blocks_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations

{
  "get_block": {
    "limits": [
      {
        "counter": "get_block_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

Create a free account and register Notion Private Api — nothing to install.
Add these rules — paste them, or build them visually. Tune the limits to your setup.
Point your MCP client (Claude, Cursor, anything) at your gateway URL.

ENFORCE POLICY ON NOTION PRIVATE API →

Instant setup, no code required.

FULL CATALOGUE

All 11 Notion Private Api tools

DESTRUCTIVE 1 tools

Destructive delete_blocks Remove direct child blocks from a page and archive those blocks.

WRITE 5 tools

Write append_blocks Append simplified blocks or Markdown to a page. Inserts at the end by default; pass after_block_id to insert i Write create_page Create a child page under another page from blocks or Markdown. Write replace_page_content Replace direct child blocks of a page with blocks or Markdown. Write sync_markdown_file Create a new page or replace an existing page from a local Markdown file. Write update_block_text Replace the plain text content of a block (e.g. code block). Inline markdown is NOT parsed — text is stored ve

READ 5 tools

Read get_block Read a single Notion block through the private API. Read get_block_children Read direct child blocks for a page or block through the private API. Read get_page Read a Notion page through the Notion private API. Read get_style_documentation Return the catalog of supported block types, inline annotations (bold/italic/code/link/color/mention), Markdow Read markdown_to_blocks Convert Markdown into the simplified block JSON format.

EXPLORE

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

FAQ

Questions about Notion Private Api

Can an AI agent delete data through the Notion Private Api MCP server? +

Yes. The Notion Private Api server exposes 1 destructive tools including delete_blocks. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through Notion Private Api? +

The Notion Private Api server has 5 write tools including append_blocks, create_page, replace_page_content. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach Notion Private Api.

How many tools does the Notion Private Api MCP server expose? +

11 tools across 3 categories: Destructive, Read, Write. 5 are read-only. 6 can modify, create, or delete data.

How do I enforce a policy on Notion Private Api? +

Register the Notion Private Api MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

Enforce policy on every Notion Private Api tool call.

Deterministic rules across all 11 Notion Private Api tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

ENFORCE POLICY ON NOTION PRIVATE API →

Instant setup, no code required.

11 Notion Private Api tools catalogued and risk-classified — across an index of 43,000+ MCP servers.