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
Decision gist · record as of 2026-07-27
Notion skill automates page and database operations through the Notion REST API with create, search, and update capabilities. 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.
Use it when
- notion API integration setup requires creating an integration in your Notion workspace, obtaining authentication credentials.
- Yes, notion supports searching and retrieving database content using REST API queries.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Install
OpenHands/extensions/notion · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
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
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Automate Notion page and database operations via REST API”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Access your Notion workspace to retrieve page content, search across pages and databases, query database rows, and create or update pages programmatically. The skill handles authentication automatically through managed OAuth or internal integration credentials.
This skill connects your Notion workspace to external workflows using the Notion REST API. Search and retrieve pages, read full content, append blocks, query databases with filters, and create new entries—all authenticated through OAuth. Perfect for syncing Notion data with other tools and automating workspace updates.
Work with Notion workspaces programmatically using REST calls. This skill covers authentication setup, all major endpoints for pages and databases, request formatting, rate limits, and best practices for safe data operations.
This skill exposes the Notion API to read and write pages, databases (called data sources in the latest API version), and blocks. Set up authentication with your integration key, then search, create, update, and query your Notion workspace programmatically.
Control Notion directly from your terminal using curl and the Notion API. Create pages and databases, query data sources with filters and sorts, update properties, and add content to blocks—all without leaving the command line.
This skill exposes the Notion API through curl, enabling you to programmatically create, retrieve, update, and delete pages, databases, and blocks. Work with properties like titles, dates, selections, and relations using standard HTTP requests authenticated with your Notion API key.