notion

npx skills add SafeAI-Lab-X/ClawKeeper --skill notion --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# notion Use the Notion API to create/read/update pages, data sources (databases), and blocks. ## Setup 1. Create an integration at https://notion.so/my-integrations 2. Copy the API key (starts with `ntn_` or `secret_`) 3. Store it: ```bash mkdir -p ~/.config/notion echo "ntn_your_key_here" > ~/.config/notion/api_key ``` 4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name) ## API Basics All requests need: ```bash NOTION_KEY=$(cat ~/.config/notion/api_key) curl -X GET "https://api.notion.com/v1/..." \ -H "Authorization: Bearer $NOTION_KEY" \ -H "Notion-Version: 2025-09-03" \ -H "Content-Type: application/json" ``` > **Note:** The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API. ## Common Operations **Search for pages and data sources:** ```bash curl -X POST "https://api.notion.com/v1/search" \ -H "Authorization: Bearer $NOTION_KEY" \ -H "Notion-Version: 2025-09-03" \ -H "Content-Type: application/json" \ -d '{"query": "page title"}' ``` **Get page:** ```bash curl "https://api.notion.com/v1/pages/{page_id}" \ -H "Authorization: Bearer $NOTI

mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
curl -X GET "https://api.notion.com/v1/..." \
curl -X POST "https://api.notion.com/v1/search" \
curl "https://api.notion.com/v1/pages/{page_id}" \
curl "https://api.notion.com/v1/blocks/{page_id}/children" \
curl -X POST "https://api.notion.com/v1/pages" \
curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
curl -X POST "https://api.notion.com/v1/data_sources" \
curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \