notion
This skill provides REST API access to create, search, and update Notion pages and databases. It supports direct API calls with proper authentication headers and includes guidance on MCP tool availability, environment setup, and sharing requirements for integrations.
Notion skill automates page and database operations through the Notion REST API with create, search, and update capabilities.
AI-generated summary based on this skill's SKILL.md
Install
OpenHands/extensions/notion · repository language: Python
git clone https://github.com/OpenHands/extensions
cp -r extensions/skills/notion ~/.claude/skills/notionFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to create Notion pages programmatically?
notion provides REST API access to create pages and databases programmatically. You authenticate with proper headers, then call the API to construct new pages with content blocks. The skill includes guidance on setting up your integration, managing authentication tokens, and structuring API requests for page creation within your Notion workspace hierarchy.
What's involved in notion API integration setup?
notion API integration setup requires creating an integration in your Notion workspace, obtaining authentication credentials, and configuring environment variables with your integration key. The skill covers authentication header requirements, MCP tool availability for different environments, and sharing permissions needed for your integration to access databases and pages.
Can I search a notion database with the API?
Yes, notion supports searching and retrieving database content using REST API queries. The skill provides examples for constructing search requests, filtering results, and retrieving specific pages or database entries. You can combine search with update operations to automate workflows that find and modify Notion content.
How do I append blocks to notion pages?
notion allows you to append and update content blocks in existing pages via REST API. The skill explains how to structure block append requests, add different content types (text, lists, code blocks, etc.), and manage page structure. This enables automation of documentation and runbook updates without manual edits.
How can I automate notion documentation and runbooks?
notion supports programmatic creation and management of documentation and runbooks through its REST API. The skill provides patterns for automating page creation, organizing content hierarchies, appending blocks, and updating existing pages. Combined with search capabilities, you can build workflows that generate, maintain, and update knowledge bases automatically.
What authentication does notion require for API access?
notion requires proper authentication headers including your integration token or API key to access pages and databases. The skill covers setting up authentication, managing credentials securely in environment variables, and understanding sharing requirements for integrations to access specific workspaces and pages.
SKILL.md
rendered from the published skill — quoted content, verbatim
Notion
Windows PowerShell equivalents for the repeated Notion REST curl, environment-variable, and JSON-body snippets are in references/windows.md.
<IMPORTANT>
If authenticated Notion MCP tools are available in the environment, use them first. MCP tools do not require passing NOTION_INTEGRATION_KEY as a tool argument; authentication is handled by the configured MCP integration.
Use the direct Notion REST API examples below only when MCP is unavailable or when you explicitly need raw API/curl access. For that direct-API path, first check whether the required environment variable is set:
[ -n "$NOTION_INTEGRATION_KEY" ] && echo "NOTION_INTEGRATION_KEY is set" || echo "NOTION_INTEGRATION_KEY is NOT set"
If it’s missing and you need the direct API path, ask the user to provide it (or connect a Notion integration) before proceeding:
- NOTION_INTEGRATION_KEY: Notion integration secret (starts with ntn_...)
Whether you use MCP or the direct API,
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 6 files
skills/notion/.claude-plugin
skills/notion/.codex-plugin
skills/notion/.plugin/plugin.json
skills/notion/README.md
skills/notion/SKILL.md
skills/notion/references/windows.md