notion

Installation
SKILL.md

Notion

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, also confirm the configured integration has been shared with the target page/database in Notion.

Base headers for direct API calls

Related skills

More from openhands/skills

Installs
42
GitHub Stars
99
First Seen
Jan 24, 2026