# Send Notion API Integration to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "notion-api-integration", "name": "Notion API Integration", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/ivangdavila/notion-api-integration", "canonicalUrl": "https://clawhub.ai/ivangdavila/notion-api-integration", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/notion-api-integration", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-api-integration", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "blocks.md", "databases.md", "errors.md", "filters.md", "memory-template.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "notion-api-integration", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T12:17:39.762Z", "expiresAt": "2026-05-07T12:17:39.762Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-api-integration", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-api-integration", "contentDisposition": "attachment; filename=\"notion-api-integration-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "notion-api-integration" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/notion-api-integration" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/notion-api-integration", "downloadUrl": "https://openagent3.xyz/downloads/notion-api-integration", "agentUrl": "https://openagent3.xyz/skills/notion-api-integration/agent", "manifestUrl": "https://openagent3.xyz/skills/notion-api-integration/agent.json", "briefUrl": "https://openagent3.xyz/skills/notion-api-integration/agent.md" } } ``` ## Documentation ### Notion API Integration Complete Notion API reference. See auxiliary files for detailed operations. ### Quick Start curl 'https://api.notion.com/v1/users/me' \\ -H "Authorization: Bearer $NOTION_API_KEY" \\ -H "Notion-Version: 2022-06-28" ### Setup On first use, read setup.md. Preferences stored in ~/notion-api-integration/memory.md. ### When to Use Any Notion operation: databases, pages, blocks, users, search, comments, properties. ### Architecture ~/notion-api-integration/ ├── memory.md # Workspace context └── databases.md # Tracked database IDs ### Quick Reference 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 ### Core Rules 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 ### Authentication 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" ### Common Traps 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 ### External Endpoints EndpointPurposehttps://api.notion.com/v1/*All Notion API operations No other endpoints are accessed. ### Security & Privacy 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 ### Scope 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 ### Trust By using this skill, data is sent to Notion (notion.com). Only install if you trust Notion with your workspace data. ### Related Skills Install with clawhub install if user confirms: api — REST API patterns pkm — Personal knowledge management productivity — Task and productivity workflows ### Feedback If useful: clawhub star notion-api-integration Stay updated: clawhub sync ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ivangdavila - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T12:17:39.762Z - Expires at: 2026-05-07T12:17:39.762Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/notion-api-integration) - [Send to Agent page](https://openagent3.xyz/skills/notion-api-integration/agent) - [JSON manifest](https://openagent3.xyz/skills/notion-api-integration/agent.json) - [Markdown brief](https://openagent3.xyz/skills/notion-api-integration/agent.md) - [Download page](https://openagent3.xyz/downloads/notion-api-integration)