← Back to Skills Marketplace
9950
Downloads
8
Stars
20
Active Installs
11
Versions
Install in OpenClaw
/install notion-api-skill
Description
Notion API integration with managed OAuth. Query databases, search pages, and read workspace content. Write operations require explicit user confirmation of...
Usage Guidance
Install only if you trust Maton to broker Notion access. Use the least-privileged Notion connection available, specify the intended connection when you have multiple workspaces, and approve writes or deletes only after checking the exact page, database, or block ID.
Capability Analysis
Type: OpenClaw Skill
Name: notion-api-skill
Version: 1.0.10
The skill provides a managed OAuth integration for the Notion API through a third-party proxy service (api.maton.ai). The documentation in SKILL.md is comprehensive and includes explicit safety instructions for the AI agent, such as requiring user confirmation for all write operations and verifying connection IDs. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the code and instructions are consistent with the stated purpose of providing a simplified interface for Notion workspace management.
Capability Assessment
Purpose & Capability
The skill's Notion read, search, database, page, block, and user capabilities match its stated purpose; write and delete operations are high-impact but disclosed and framed as requiring explicit user approval.
Instruction Scope
Instructions include a broad native Notion API proxy path, but they also require confirmation of the exact target resource and connection before create, update, delete, bulk, or destructive actions.
Install Mechanism
The artifact is instruction-only with a single SKILL.md and no executable scripts; it documents optional external installation of the Maton CLI through npm or Homebrew.
Credentials
Network access, a MATON_API_KEY, and delegated Notion OAuth are proportionate for this integration, but users are trusting Maton as a proxy for Notion requests and responses.
Persistence & Privilege
OAuth connections persist through Maton and can grant continuing access to selected Notion content, but the skill documents listing and deleting connections and shows no hidden background persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install notion-api-skill - After installation, invoke the skill by name or use
/notion-api-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
- Clarified that all write operations (create, update, delete) require explicit user confirmation of the target resource and connection before execution.
- Updated the description and introductory text to emphasize stricter confirmation requirements for write actions.
- Adjusted documentation and usage notes to specify no writing is permitted without prior user approval.
- Reinforced security best practices and scope boundaries regarding resource operations and connection selection.
v1.0.9
Version 1.0.9
- Expanded Security & Permissions section with detailed user safety steps for write operations.
- Added requirements for confirming targets (IDs), verifying connections, and stating if an action is reversible or destructive before any write.
- Listed specific irreversible/high-risk operations that require extra caution.
- Clarified strict scope boundaries and the need for explicit user approval before bulk or batch changes.
- No changes to the skill's functionality or API surface.
v1.0.8
Version 1.0.8
- Added comprehensive CLI usage examples for interacting with Notion via the Maton CLI.
- Expanded installation and authentication instructions, including Homebrew and npm options.
- Provided side-by-side CLI and Python code samples for all major workflows (connections, search, data sources, pages).
- Clarified how to specify and manage multiple Notion connections in both CLI and API workflows.
- Improved documentation structure, making setup and usage clearer for both CLI and API users.
v1.0.7
- Changed all base URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai.
- Updated sample code and instructions to use the new api.maton.ai endpoints.
- Added a security & permissions section, clarifying write operation requirements.
- Minor wording and formatting improvements in documentation.
- Removed the LICENSE.txt file.
v1.0.6
- Added homepage field to metadata for better discoverability and navigation to Maton platform.
- Minor metadata improvements; no changes to functionality or API usage.
v1.0.5
- Added a metadata section for clawdbot, specifying an emoji and required environment variable (MATON_API_KEY).
- No functional or API changes; documentation and compatibility remain the same.
v1.0.4
Version 1.0.4
- No file changes detected in this release.
- No updates or modifications to documentation or source code.
v1.0.3
- Added a note recommending the api-gateway skill for third party apps other than Notion.
- Replaced all shell/bash and JavaScript code examples with Python equivalents using `urllib.request` and standard libraries.
- Updated code snippets and quick start instructions to reflect the new Python-based examples for API usage and connection management.
- No changes to the API endpoints or core functionality; documentation updates only.
v1.0.2
- Clarified the gateway base URL pattern: use `/notion/{native-api-path}` instead of `/notion/v1/{endpoint}`.
- Added instructions for specifying the Notion connection via the new `Maton-Connection` header when multiple OAuth connections exist.
- Improved the "Getting Your API Key" section to mention account creation.
- Updated example connection response to include `creation_time`, `last_updated_time`, and `metadata`.
- Improved documentation formatting and consistency, with adjustments to connection management and quick start sections.
v1.0.1
- Clarified the relationship between databases and data sources: `GET /databases/{id}` now returns a `data_sources` array.
- Added an example output for the `GET /databases/{id}` data sources structure for clarity.
- Expanded connection management documentation with both "list connections" and "get single connection" response examples.
- Added example for the "Update Page Icon" endpoint.
- Improved explanations of endpoints and usage throughout for accuracy and consistency.
v1.0.0
- Initial release of Notion API integration with managed OAuth.
- Supports querying databases, creating/updating pages, and managing blocks in Notion workspaces.
- API gateway proxies requests to Notion API and handles OAuth token injection.
- Includes detailed setup instructions, API reference, connection management, and code examples (bash, JavaScript, Python).
- Databases and data sources are clearly separated for querying and schema updates.
- Comprehensive error handling and resource links provided.
Metadata
Frequently Asked Questions
What is Notion?
Notion API integration with managed OAuth. Query databases, search pages, and read workspace content. Write operations require explicit user confirmation of... It is an AI Agent Skill for Claude Code / OpenClaw, with 9950 downloads so far.
How do I install Notion?
Run "/install notion-api-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Notion free?
Yes, Notion is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Notion support?
Notion is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Notion?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.0.10.
More Skills