Profile My skills Saved My plugins Edit profile Submit a skill

Notion

Use the Notion API to create, read, update Notion pages, data sources (databases), and blocks.

XAIHT Updated
AI & ML

File contents

Notion skill

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.

XAIHT/Tlamatini/tree/main/Tlamatini/agent/skills_pkg/notion commit 3ec3483c35

Browse category

Frequently asked questions

npx skillmds@latest add xaiht/notion