← Back to Skills Marketplace
jeffreymaomao

Notion Workspace API Tools

by Jeffreymaomao · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
352
Downloads
1
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install notion-tools
Description
Use for tasks that read or modify Notion pages, data sources, or blocks via the Notion API.
Usage Guidance
This skill appears to do exactly what it says (call the Notion API) and uses only Notion endpoints, but you should verify the runtime will provide a NOTION_KEY before granting access. The SKILL.md also allows reading a fallback token file at ~/.config/notion/api_key — if you use that pattern, understand the skill will read that file to obtain credentials. Because the registry metadata does not declare NOTION_KEY as a required credential, ask the skill author or your operator where the key must come from, and only supply a token you control (prefer a least-privilege integration token). Do not paste your full token into chat; if you install or test this skill and later doubt its behavior, rotate/revoke the Notion key. Finally, confirm the skill's source or owner (source is unknown) before installing so you can trust future automated calls to your workspace.
Capability Analysis
Type: OpenClaw Skill Name: notion-tools Version: 1.0.2 The notion-tools skill bundle provides standard instructions and curl-based examples for interacting with the Notion API. It includes proactive safety guidelines for the AI agent, such as avoiding the disclosure of API keys in outputs and preferring environment variables over local files. The optional fallback to read a credential from `~/.config/notion/api_key` is a common pattern for local CLI tools and is clearly documented in `SKILL.md` and `references/setup.md` without any evidence of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
The name, description, and runtime instructions all describe legitimate Notion API operations (search, read, create, update, append, trash/restore). Requested actions and referenced endpoints (https://api.notion.com/v1/...) are consistent with the stated purpose.
Instruction Scope
The SKILL.md stays within Notion API usage and gives concrete curl templates and safety rules. It does instruct the agent to prefer a runtime-provided NOTION_KEY and, as an optional local fallback, to read ~/.config/notion/api_key — which means the agent is explicitly permitted to read a local file for credentials. No unrelated system paths, other services, or external endpoints are referenced.
Install Mechanism
This is instruction-only with no install spec and no code files, so nothing is written to disk by an installer. That is the lowest-risk install model.
Credentials
The skill expects NOTION_KEY and NOTION_VERSION at runtime and provides a local-file fallback (~/.config/notion/api_key), but the registry metadata lists no required environment variables or primary credential. The omission of a declared primary credential (NOTION_KEY) is a mismatch that could confuse users about what secrets are needed and what the skill will access.
Persistence & Privilege
The skill does not request always: true, does not modify other skills or system-wide settings, and is user-invocable only. Autonomous invocation is allowed (platform default) but is not combined here with privileged persistence or broad cross-skill access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-tools
  3. After installation, invoke the skill by name or use /notion-tools
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added support and documentation for trashing and restoring pages using the `in_trash` property. - Updated API key management to prefer the runtime-provided `NOTION_KEY` variable, using the local token file only as a fallback. - Improved safety guidance: secrets are now read only when needed for Notion API requests, not during planning or explanation. - Clarified that “trashing” a page is not a permanent delete and updated related instructions. - Expanded workflow and API notes to cover trash, restore, and credential handling workflows.
v1.0.1
**Expanded documentation and added usage references.** - Added new reference files: blocks, examples, property patterns, setup, and troubleshooting. - Clarified recommended API workflows, including search-first and inspect-before-mutate patterns. - Added safety guidelines and environment readiness checks. - Provided links to request/response templates and troubleshooting tips. - Updated API terminology for Notion API version 2025-09-03.
v1.0.0
Initial release of Notion Tools skill. - Provides guides to use the Notion API for managing pages, data sources (databases), and blocks - Supports setup instructions, authentication, and usage examples for all main API endpoints - Documents new "data sources" naming and endpoint changes in API version 2025-09-03 - Lists common property types and formatting for database items - Covers creating, querying, updating pages and data sources, and adding blocks - Notes key usage tips, limitations, and rate limits
Metadata
Slug notion-tools
Version 1.0.2
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Notion Workspace API Tools?

Use for tasks that read or modify Notion pages, data sources, or blocks via the Notion API. It is an AI Agent Skill for Claude Code / OpenClaw, with 352 downloads so far.

How do I install Notion Workspace API Tools?

Run "/install notion-tools" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Notion Workspace API Tools free?

Yes, Notion Workspace API Tools is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Notion Workspace API Tools support?

Notion Workspace API Tools is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Notion Workspace API Tools?

It is built and maintained by Jeffreymaomao (@jeffreymaomao); the current version is v1.0.2.

💬 Comments