notion git:20261022.8c577d3A

Immutable. This exact content never changes and is served at /api/v1/blob/5488afca5a4a7154.

---
name: notion
description: Use the Notion API to create, read, update Notion pages, data sources (databases), and blocks.
metadata:
  openclaw:
    emoji: "📝"
    requires:
      env: ["NOTION_API_KEY"]
    primaryEnv: "NOTION_API_KEY"
  tlamatini:
    runtime: in-process
    requires_tools: ["chat_agent_apirer","chat_agent_executer"]
    requires_mcps: []
    budget:
      max_iterations: 6
      max_seconds: 90
      max_tokens: 12000
    permissions:
      filesystem:
        read:  ["~/.config/notion/api_key"]
        write: []
      shell:
        - "curl -X * https://api.notion.com/v1/*"
      network: allow
      db:      deny
    inputs:
      - { name: action, type: enum,   required: true,
          values: ["search","page-create","page-update","db-query","block-append"] }
      - { name: payload, type: object, required: true }
    outputs:
      - { name: response, type: object, required: true }
    triggers:
      keywords: ["notion","page","database","data source"]
---
<!--
═══════════════════════════════════════════════════════════════════
  ✦  T L A M A T I N I  ✦   —   "one who knows"
  Created by  Angela López Mendoza   ·   @angelahack1
  Developer · Architect · Creator of Tlamatini
  Tlamatini Author Banner — do not remove (Angela's name is kept in every build)
═══════════════════════════════════════════════════════════════════
-->

# Notion skill

> Current release: **[v1.90.0](../../../../docs/changes/2026-10-22-v1.90.0.md)**. Dated records below retain their original evidence dates.


> **HEADLESS IS FORBIDDEN. VISIBLE FOREGROUND EXECUTION ONLY.** Every command, automated test, diagnostic, script, build, agent and browser must run in a visible foreground window on Angela's real desktop. Use forked CMD/PowerShell windows, `execute_forked_window: true`, and `headless: false`. Monitor live; if visibility cannot be confirmed, do not run. Read the [mandatory execution policy](../../../../TestsVisiblesAndVisibleExecutionFromClaude2Codex.md).

## Setup

1. Create an integration at https://notion.so/my-integrations.
2. Save the API key under `~/.config/notion/api_key` (no newline).
3. Share the target pages/databases with the integration.

## API basics

All requests:
```
Authorization: Bearer $NOTION_KEY
Notion-Version: 2025-09-03
Content-Type: application/json
```

## Procedure

Map `${input.action}` to the right endpoint:

- `search`       → `POST /v1/search`
- `page-create`  → `POST /v1/pages`
- `page-update`  → `PATCH /v1/pages/{page_id}`
- `db-query`     → `POST /v1/data_sources/{id}/query`
- `block-append` → `PATCH /v1/blocks/{block_id}/children`

Compose the JSON body from `${input.payload}`. Issue with
`chat_agent_apirer`. Return the parsed JSON response.