← Back to Skills Marketplace
Notion API Tools
by
timenotspace
· GitHub ↗
· v1.1.0
6573
Downloads
5
Stars
23
Active Installs
2
Versions
Install in OpenClaw
/install notion-api
Description
Generic Notion API CLI (Node) for search, querying data sources (databases), and creating pages. Configure with NOTION_KEY (or ~/.config/notion/api_key).
Usage Guidance
Install only if you intend to let an agent use a Notion integration token. Use a dedicated least-privilege Notion integration, share only the pages or databases needed, and review any create-page, append-blocks, or update-block command before it runs because those can change workspace content.
Capability Analysis
Type: OpenClaw Skill
Name: notion-api
Version: 1.1.0
The skill bundle provides a Node.js CLI for the Notion API, allowing search, querying, and page creation. It securely handles API keys by reading from environment variables or a standard configuration file (`~/.config/notion/api_key`), and all network requests are directed to the legitimate Notion API endpoint (`https://api.notion.com/v1/`). The `SKILL.md` documentation is purely descriptive and does not contain any prompt injection attempts. The code uses only built-in Node.js modules and shows no evidence of data exfiltration to unauthorized destinations, malicious execution, persistence mechanisms, or obfuscation.
Capability Assessment
Purpose & Capability
The main purpose is coherent with the artifacts: a Node CLI for Notion search, database queries, page creation, and related block operations. The SKILL.md summary omits block retrieval, append, and update commands, but those commands are visible in the script header and CLI help and remain aligned with a generic Notion API tool.
Instruction Scope
Commands are explicit user-invoked CLI actions and there is no evidence of automatic execution. Several commands can mutate Notion data, including create-page, append-blocks, and update-block, so write actions should be confirmed before use.
Install Mechanism
The bundle contains only SKILL.md and a dependency-free Node script. No installer, package download, postinstall behavior, or generated persistence mechanism is present.
Credentials
Reading NOTION_KEY or ~/.config/notion/api_key is proportional for a Notion API CLI and is disclosed. The token grants whatever Notion access the integration has, so least-privilege setup matters.
Persistence & Privilege
The script reads an existing token at runtime and sends requests only to https://api.notion.com/v1/. It does not store credentials, create background services, modify local agent state, or attempt privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install notion-api - After installation, invoke the skill by name or use
/notion-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- Updated Notion API version header to default to 2025-09-03.
- Documentation improvements and minor clarifications in SKILL.md.
v1.0.0
- Updated skill.
Metadata
Frequently Asked Questions
What is Notion API Tools?
Generic Notion API CLI (Node) for search, querying data sources (databases), and creating pages. Configure with NOTION_KEY (or ~/.config/notion/api_key). It is an AI Agent Skill for Claude Code / OpenClaw, with 6573 downloads so far.
How do I install Notion API Tools?
Run "/install notion-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Notion API Tools free?
Yes, Notion API Tools is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Notion API Tools support?
Notion API Tools is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Notion API Tools?
It is built and maintained by timenotspace (@timenotspace); the current version is v1.1.0.
More Skills