← Back to Skills Marketplace
Notion API Tools
by
timenotspace
· GitHub ↗
· v1.1.0
6924
Downloads
5
Stars
0
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 integration, share only the specific pages or databases needed, and carefully review any `create-page`, `append-blocks`, or `update-block` command 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 artifacts are coherent with a generic Notion API CLI: search, data-source query, page creation, block retrieval, block child listing, and block append/update all target the official Notion API. The SKILL.md summary omits the block commands, but they are visible in the script header and CLI help and remain purpose-aligned.
Instruction Scope
Commands are explicit user-invoked CLI actions, not automatic background behavior. Mutating commands are present (`create-page`, `append-blocks`, and `update-block`), so users should review invocations before allowing an agent to run them.
Install Mechanism
The bundle contains only documentation and a dependency-free Node.js script; there is no installer, package download, postinstall hook, obfuscation, or generated persistence.
Credentials
Reading `NOTION_KEY` or `~/.config/notion/api_key` and sending requests to `https://api.notion.com/v1/` is expected for a Notion API tool, but token scope and workspace sharing determine how much Notion data the agent can access or modify.
Persistence & Privilege
No evidence shows credential storage, privilege escalation, local agent-state modification, background workers, destructive local actions, or network destinations outside the Notion API.
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 6924 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