{"skill":{"slug":"notion-skill","displayName":"Notion","summary":"Work with Notion pages and databases via the official Notion API.","description":"---\nname: notion\ndescription: Work with Notion pages and databases via the official Notion API.\nhomepage: https://developers.notion.com\nmetadata:\n  clawdbot:\n    emoji: 🧠\n    requires:\n      env:\n        - NOTION_API_KEY\n    install:\n      - id: node\n        kind: note\n        label: \"Requires notion-cli (Node.js) or notion-cli-py (Python). See docs below.\"\n---\n\n# Notion\n\nThis skill lets the agent work with **Notion pages and databases** using the official Notion API.\n\nThe skill is declarative: it documents **safe, recommended operations** and assumes a local CLI\n(`notion-cli`) that actually performs API calls.\n\n## Authentication\n\n- Create a Notion Integration at https://www.notion.so/my-integrations\n- Copy the Internal Integration Token.\n- Export it as:\n\n```bash\nexport NOTION_API_KEY=secret_xxx\n```\n\nShare the integration with the pages or databases you want to access.\nUnshared content is invisible to the API.\n\n## Profiles (personal / work)\n\nYou may define multiple profiles (e.g. personal, work) via env or config.\n\nDefault profile: personal\n\nOverride via:\n\n```bash\nexport NOTION_PROFILE=work\n```\n\n## Pages\n\n**Read page:**\n\n```bash\nnotion-cli page get <page_id>\n```\n\n**Append blocks:**\n\n```bash\nnotion-cli block append <page_id> --markdown \"...\"\n```\n\nPrefer appending over rewriting content.\n\n**Create page:**\n\n```bash\nnotion-cli page create --parent <page_id> --title \"...\"\n```\n\n## Databases\n\n**Inspect schema:**\n\n```bash\nnotion-cli db get <database_id>\n```\n\n**Query database:**\n\n```bash\nnotion-cli db query <database_id> --filter <json> --sort <json>\n```\n\n**Create row:**\n\n```bash\nnotion-cli page create --database <database_id> --props <json>\n```\n\n**Update row:**\n\n```bash\nnotion-cli page update <page_id> --props <json>\n```\n\n## Schema changes (advanced)\n\nAlways inspect diffs before applying schema changes.\n\nNever modify database schema without explicit confirmation.\n\nRecommended flow:\n\n```bash\nnotion-cli db schema diff <database_id> --desired <json>\nnotion-cli db schema apply <database_id> --desired <json>\n```\n\n## Safety notes\n\n- Notion API is rate-limited; batch carefully.\n- Prefer append and updates over destructive operations.\n- IDs are opaque; store them explicitly, do not infer from URLs.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":13457,"installsAllTime":92,"installsCurrent":91,"stars":15,"versions":1},"createdAt":1769524433792,"updatedAt":1778485857338},"latestVersion":{"version":"1.0.0","createdAt":1769524433792,"changelog":"Initial release of the Notion skill:\n\n- Provides commands to interact with Notion pages and databases via the official Notion API.\n- Supports reading, creating, and updating pages and database rows using a local `notion-cli` tool.\n- Documents safe usage patterns, including handling profiles and authentication via `NOTION_API_KEY`.\n- Includes guidance on inspecting and updating database schemas.\n- Emphasizes safety: prefer appending/updating, always inspect diffs before schema changes, and respect rate limits.","license":null},"metadata":{"setup":[{"key":"NOTION_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"dimagious","userId":"s17ftha2n17vagm9sprszhkc7s84cd24","displayName":"Dmitriy Yurkin","image":"https://avatars.githubusercontent.com/u/26202319?v=4"},"moderation":null}