cyberneticlibrary

Manage Notion pages and databases

notion-2skillsetup L2609
sundial-org/awesome-openclaw-skills
What it does

Query and update Notion pages and databases

Best for

Agents needing read-modify-append workflows on Notion databases without destructive rewrites.

Inputs
  • · page_id or database_id
  • · markdown blocks (for append)
  • · JSON filter and sort specs (for queries)
  • · JSON property objects (for updates)
Outputs
  • · page content (blocks, properties)
  • · database schema (fields, types)
  • · query results (rows matching filter)
  • · updated page ID
Requires
  • · notion-cli (Node.js or Python wrapper)
  • · NOTION_API_KEY env var
  • · Notion API v1
Preconditions
  • · Integration created at notion.so/my-integrations
  • · Integration token exported as NOTION_API_KEY
  • · Integration shared with target pages/databases
Failure modes
  • · API rate-limit exceeded (backoff required)
  • · Unshared pages/databases invisible to API
  • · Invalid page_id or database_id format
  • · Schema mutation without explicit confirmation
Trust signals
  • · Official Notion API documented at developers.notion.com
  • · Explicit guardrails against schema changes without confirmation
  • · Recommends append-over-rewrite pattern for safety