Agent skill · marketing growth · bighardperson
notion
Notion API integration with managed OAuth. Query databases, create and update pages, manage blocks. Use this skill when users want to interact with Notion workspaces, databases, or pages. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Why this skill is useful
Provides specific commands and patterns for interacting with the Notion API that the AI wouldn't reliably generate on its own.
What it needs
Requires maton account access. About 5k tokens when loaded. Last updated 2026-04-26. 34 stars on the source repository.
What this skill does
Notion Access the Notion API with managed OAuth authentication. Query databases, create pages, manage blocks, and search your workspace. Quick Start Base URL Replace {native-api-path} with the actual Notion API endpoint path. The gateway proxies requests to api.notion.com and automatically injects your OAuth token. Required Headers All Notion API requests require the version header: Authentication All requests require the Maton API key in the Authorization header: Environment Variable: Set your API key as MATONAPIKEY: Getting Your API Key 1. Sign in or create an account at maton.ai 2. Go to maton.ai/settings 3. Copy your API key Connection Management Manage your Notion OAuth connections at https://ctrl.maton.ai. List Connections Create Connection Get Connection Response: Open the returned url in a browser to complete OAuth authorization. Delete Connection Specifying Connection If you have multiple Notion connections, specify which one to use with the Maton-Connection header: If omitted, the gateway uses the default (oldest) active connection. Key Concept: Databases vs Data Sources In API version 2025-09-03, databases and data sources are separate: Concept Use For --------- --------- Database Creating databases, getting data source IDs Data Source Querying, updating schema, updating properties Use GET /databases/{id} to get the datasources array, then use /datasources/ endpoints: API Reference Search Search for pages: Search for data sources: Data Sources Get Data Source Query Data Source Update Data Source Databases Get Database Create Database Pages Get Page Create Page Create Page in Data Source Update Page Properties Update Page Icon Archive Page Blocks Get Block Children Append Block Children Delete Block Users List Users Get Current User Filter Operators equals, doesnotequal contains, doesnotcontain startswith, endswith isempty, isnotempty greaterthan, lessthan Block Types paragraph, heading1, heading2, heading3 bulletedlistitem, numberedlistitem todo, code, qu …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/notion-api-skill