← Back to Skills Marketplace
Notion Skill Publish
by
gaoyuan@ai
· GitHub ↗
· v1.0.1
· MIT-0
133
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install notion-pro
Description
Complete Notion API integration with Python CLI offering auto-pagination, recursive blocks, rate-limit retry, and agent operation strategies for efficient No...
Usage Guidance
This skill's code and docs implement a legitimate Notion CLI and only call the official Notion API, but the registry metadata does not list the credential and config file it actually uses. Before installing: (1) expect to provide a Notion integration API key (ntn_xxx) and prefer a token scoped minimally; (2) confirm where you will store the key — environment variable NOTION_API_KEY or ~/.openclaw/openclaw.json — and ensure the chosen storage meets your security policies; (3) review scripts/notion_api.py yourself (it is included) to verify it only contacts https://api.notion.com and doesn't exfiltrate data elsewhere; (4) consider creating a Notion integration with limited access and sharing only necessary pages/databases; (5) ask the publisher to correct the registry metadata to declare NOTION_API_KEY (primary credential) and the config path so consent and gating work properly. If you need higher assurance, run the skill in an isolated environment first or audit network traffic to confirm only Notion API calls occur.
Capability Analysis
Type: OpenClaw Skill
Name: notion-pro
Version: 1.0.1
The 'notion-pro' skill is a comprehensive and well-structured Notion API integration for OpenClaw. The core logic in `scripts/notion_api.py` uses only Python standard libraries to interact with the official Notion API (api.notion.com), implementing robust features like 429 rate-limit retries, recursive block fetching, and automatic pagination. The instructions in `SKILL.md` and `SKILL_CN.md` are designed to guide the AI agent through effective operational strategies (e.g., search before read, batching writes) and do not contain any malicious prompt injection or unauthorized data access commands.
Capability Assessment
Purpose & Capability
Name/description, README, SKILL.md and the Python CLI source are coherent: this is a Notion API integration offering search, read, write, pagination, recursive block fetching, and rate-limit retry. The code calls only Notion endpoints (https://api.notion.com) and implements the features claimed.
Instruction Scope
SKILL.md instructs agents to use the included scripts/notion_api.py for all Notion operations and documents expected workflows and limits. The runtime instructions and the script stay within Notion-related operations; they do not reference unrelated external endpoints. The script does, however, read user config (~/.openclaw/openclaw.json) and environment variables for the API key — this is relevant and explicitly documented in SKILL.md.
Install Mechanism
There is no install spec (instruction-only with a bundled script). No third-party downloads or package installs are performed by the skill — low install risk.
Credentials
Registry metadata declares no required env vars or config paths, but SKILL.md and the script clearly require a Notion API key (NOTION_API_KEY) and will read ~/.openclaw/openclaw.json for skills.entries.notion-pro or notion. The skill should declare this primary credential/config path. Requesting a Notion API key is proportionate to the stated purpose, but the omission from metadata is an inconsistency that affects user consent and gating.
Persistence & Privilege
The skill is not marked always:true and does not request system-wide changes. It reads its own OpenClaw config and environment variables but does not modify other skills or global settings. Autonomous invocation is allowed by default (normal).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install notion-pro - After installation, invoke the skill by name or use
/notion-pro - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Bug fixes: (1) API key priority - config file now takes precedence over env var; (2) --filter database auto-maps to data_source for API 2025-09-03; (3) --after append count now reports actual appended blocks
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Notion Skill Publish?
Complete Notion API integration with Python CLI offering auto-pagination, recursive blocks, rate-limit retry, and agent operation strategies for efficient No... It is an AI Agent Skill for Claude Code / OpenClaw, with 133 downloads so far.
How do I install Notion Skill Publish?
Run "/install notion-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Notion Skill Publish free?
Yes, Notion Skill Publish is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Notion Skill Publish support?
Notion Skill Publish is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Notion Skill Publish?
It is built and maintained by gaoyuan@ai (@baixiaodev); the current version is v1.0.1.
More Skills