Does this skill support both pages and databases?

Yes, it can search for both and create pages within existing databases by targeting the database ID as the parent.

Can Claude search my entire Notion workspace?

Claude can only search for and interact with pages or databases that have been explicitly shared with the integration in the Notion UI.

How do I add content to an existing Notion page?

The skill uses the Patch Block Children endpoint, allowing Claude to append new blocks like headings and paragraphs to any existing page ID.

Why am I getting a 404 error even with a valid API key?

This usually means the integration hasn't been 'shared' with the page. In Notion, go to the page, click the '...' menu, and select 'Add connections' to find your integration.

What is required to use the Notion skill?

You need a Notion Integration Key (starting with 'ntn_') set as an environment variable and you must manually share the target Notion pages with your integration.

Notion Integration

Name: Notion Integration
Author: OpenHands

byOpenHands

•

Content Management

Automates Notion workspace management by creating, searching, and updating pages or databases through the Notion API.

The Notion skill empowers Claude to interact seamlessly with your Notion workspace, enabling automated documentation, runbook generation, and knowledge base maintenance. It provides the capability to search for existing pages, create new content under parent pages, and append information to existing blocks using the official Notion API. This is particularly useful for developers who want to sync project progress, document architectural decisions, or automate wiki updates without leaving their terminal environment, ensuring that project documentation stays as up-to-date as the code itself.

Key Features

01Support for Notion's hierarchical block-based architecture

02Automated environment variable validation for API security

0340 GitHub stars

04Search for Notion pages and databases by title using the search endpoint

05Create new pages with custom properties and structured content blocks

06Append rich text, headings, and other block types to existing pages

Use Cases

01Syncing development milestones and project logs to a shared team wiki

02Automatically generating and updating technical runbooks based on code changes

03Searching and retrieving internal documentation directly within the AI coding session

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openhands/skills notion

For use in Claude.ai and ChatGPT

Download Skill