Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Complete Notion API for databases, pages, blocks, users, search, comments, and property types with pagination and error handling.
Complete Notion API for databases, pages, blocks, users, search, comments, and property types with pagination and error handling.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Complete Notion API reference. See auxiliary files for detailed operations.
curl 'https://api.notion.com/v1/users/me' \ -H "Authorization: Bearer $NOTION_API_KEY" \ -H "Notion-Version: 2022-06-28"
On first use, read setup.md. Preferences stored in ~/notion-api-integration/memory.md.
Any Notion operation: databases, pages, blocks, users, search, comments, properties.
~/notion-api-integration/ โโโ memory.md # Workspace context โโโ databases.md # Tracked database IDs
TopicFileSetup and memorysetup.md, memory-template.mdDatabases: query, create, updatedatabases.mdPages: CRUD, propertiespages.mdBlocks: content, childrenblocks.mdProperty types referenceproperties.mdFilters and sortsfilters.mdSearch and userssearch.mdPagination patternspagination.mdError handlingerrors.md
API version header required - Always include Notion-Version: 2022-06-28 (or newer) Bearer token auth - Authorization: Bearer $NOTION_API_KEY Page IDs without dashes - Remove dashes from URLs: abc123def456 not abc-123-def-456 Property names are case-sensitive - Match exactly as defined in database Pagination mandatory - Use start_cursor for results over 100 items Rate limits - 3 requests/second average, burst allowed Integration access - Pages must be shared with integration to access
Required environment variable: NOTION_API_KEY - Internal integration token (starts with ntn_ or secret_) # All requests require these headers curl 'https://api.notion.com/v1/...' \ -H "Authorization: Bearer $NOTION_API_KEY" \ -H "Notion-Version: 2022-06-28" \ -H "Content-Type: application/json"
Missing Notion-Version header - 400 error Page ID with dashes - 404 not found Property name mismatch - Silent failure or error Skipping pagination - Miss data beyond first 100 No integration access - 404 even if page exists
EndpointPurposehttps://api.notion.com/v1/*All Notion API operations No other endpoints are accessed.
Environment variable used: NOTION_API_KEY - for API authentication Sent to Notion: Database queries, page content, block updates via api.notion.com Stays local: API key (in environment variable only), ~/notion-api-integration/ preferences Never: Store API keys in files, access pages not shared with integration
This skill ONLY: Makes requests to api.notion.com endpoints Stores preferences in ~/notion-api-integration/ Provides curl and code examples This skill NEVER: Accesses files outside ~/notion-api-integration/ Makes requests to other endpoints Stores API keys in files
By using this skill, data is sent to Notion (notion.com). Only install if you trust Notion with your workspace data.
Install with clawhub install <slug> if user confirms: api โ REST API patterns pkm โ Personal knowledge management productivity โ Task and productivity workflows
If useful: clawhub star notion-api-integration Stay updated: clawhub sync
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.