Agent skill · software engineering · bighardperson
notion
Work with Notion pages and databases via the official Notion API.
Why this skill is useful
Adds specific commands for interacting with Notion's API that the AI wouldn't reliably generate on its own.
What it needs
Requires notion-cli installed locally. Requires notion account access. About 1k tokens when loaded. Last updated 2026-04-26. 34 stars on the source repository.
What this skill does
Notion This skill lets the agent work with Notion pages and databases using the official Notion API. The skill is declarative: it documents safe, recommended operations and assumes a local CLI (notion-cli) that actually performs API calls. Authentication Create a Notion Integration at https://www.notion.so/my-integrations Copy the Internal Integration Token. Export it as: Share the integration with the pages or databases you want to access. Unshared content is invisible to the API. Profiles (personal / work) You may define multiple profiles (e.g. personal, work) via env or config. Default profile: personal Override via: Pages Read page: Append blocks: Prefer appending over rewriting content. Create page: Databases Inspect schema: Query database: Create row: Update row: Schema changes (advanced) Always inspect diffs before applying schema changes. Never modify database schema without explicit confirmation. Recommended flow: Safety notes Notion API is rate-limited; batch carefully. Prefer append and updates over destructive operations. IDs are opaque; store them explicitly, do not infer from URLs.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/notion-skill