notion

name	notion
description	Read, search, create, and update Notion pages and databases via the Notion API.
always	false
metadata	{"clawlite":{"emoji":"📝","auth":{"requiredEnv":["NOTION_API_KEY"]}}}

Notion

Use this skill when the user wants to interact with Notion pages, databases, or workspaces.

Auth

Set NOTION_API_KEY (Integration token from https://www.notion.so/my-integrations).

Base URL

https://api.notion.com/v1
Headers: Authorization: Bearer $NOTION_API_KEY
         Notion-Version: 2022-06-28
         Content-Type: application/json

Key endpoints

POST /search                          # search pages/databases by query
GET  /pages/{page_id}                 # read a page
POST /pages                           # create a page
PATCH /pages/{page_id}                # update page properties
GET  /databases/{database_id}/query   # query a database
POST /databases/{database_id}/query   # filter/sort database rows
GET  /blocks/{block_id}/children      # read page content blocks
PATCH /blocks/{block_id}              # update a block
POST /blocks/{block_id}/children      # append blocks to a page

Search example

curl -s -X POST https://api.notion.com/v1/search \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2022-06-28" \
  -H "Content-Type: application/json" \
  -d '{"query":"meeting notes","filter":{"value":"page","property":"object"}}'

Safety notes

• Never delete pages without explicit user confirmation.
• Prefer PATCH (update) over recreating pages.