Agent skill · software engineering · aiskillstore
notion-api
This skill should be used when the user asks to "search Notion", "find in Notion", "search my Notion workspace", "create Notion page", "make a Notion page", "update Notion page", "edit Notion page", "query Notion database", "get Notion database", "read Notion page", "get page content from Notion", "list Notion pages", or mentions Notion integration, Notion workspace, or Notion API access.
Why this skill is useful
Adds TypeScript scripts for comprehensive Notion API interactions, enabling page creation, updates, and database queries that the AI cannot generate on its own.
What it needs
Requires bun installed locally. Requires notion account access. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Notion API Integration Access Notion pages, databases, and content through TypeScript scripts executed via Bun. Overview This skill provides access to the Notion API for: Search: Find pages and databases across your workspace Pages: Get, create, and update pages Databases: Query database entries with filters and sorting Blocks: Read page content as blocks All scripts return JSON and require a NOTIONTOKEN environment variable. Response Format All scripts output JSON with a consistent structure: Success Authentication Required When you receive authrequired, display to the user: Error Search Search for pages and databases across your Notion workspace. All scripts are located at ${CLAUDEPLUGINROOT}/skills/notion/scripts/. Pages Get, create, and update Notion pages. Get Page Create Page Update Page Databases Query and get information about Notion databases. Get Database Schema Returns the database title, description, and all property definitions. Query Database Common Filter Examples Blocks (Page Content) Read page content as blocks. List Page Blocks Get Specific Block Block Types Blocks can be: paragraph, heading1, heading2, heading3, bulletedlistitem, numberedlistitem, todo, toggle, code, quote, callout, divider, table, image, bookmark, and more. Each block includes: id: Block identifier type: Block type content: Text content (if applicable) hasChildren: Whether block has nested blocks children: Nested blocks (when using --recursive) Authentication Setup 1. Go to https://www.notion.so/my-integrations 2. Click "New integration" 3. Give it a name and select the workspace 4. Copy the "Internal Integration Secret" 5. Set the environment variable: 6. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/notion-api