← Back to Skills Marketplace
potatosolo

Notion Database Automation

by potatosolo · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
115
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install notion-db-automation
Description
Automate common Notion database operations like batch page creation, data filtering, content generation, and export. Use when you need to automate workflows...
Usage Guidance
This package appears to implement Notion database operations and uses only the official Notion API, but there are a few red flags you should consider before installing: - The manifest claims no required env vars, but both the docs and the code require a Notion API token (NOTION_API_TOKEN). Treat this token like any secret: only provide an integration token with minimal scope and share the specific databases with that integration rather than granting workspace-wide privileges. - The SKILL.md mentions files and features that aren't present (templates/ directory, a batch_update.py script, and 'AI-generated summary' behavior). That suggests the package or its documentation is incomplete or out-of-sync. Ask the publisher for the missing files or a corrected manifest if you need those features. - Review the code yourself (or have someone you trust do it) before giving the token to the skill. The scripts only make requests to api.notion.com and read/write CSV/JSON files, which is expected, but you should verify there are no hidden endpoints or additional network calls in other versions. - When testing, use a throwaway Notion integration and database (or limit integration access) so any unexpected behavior is contained. Avoid supplying long-lived or highly privileged tokens until you are confident in the package. If you need higher confidence, request a corrected manifest (declare NOTION_API_TOKEN as a required env var and include missing files) or obtain the package from a trusted source that publishes templates and the full codebase.
Capability Analysis
Type: OpenClaw Skill Name: notion-db-automation Version: 1.0.0 The skill bundle provides legitimate tools for automating Notion database operations via the official API. The code in scripts/notion_client.py, scripts/batch_create.py, and scripts/export_csv.py aligns with the stated purpose, and no evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The Python scripts call only the Notion API and implement querying, creating, updating (batch_create and export_csv exist), and exporting — which matches the stated purpose. However the documentation references additional artifacts that are not present (templates/ files and a batch_update.py script are mentioned but not included), and the README promises 'AI-generated summary' features that are not implemented and no LLM dependency is present. These mismatches reduce confidence in the package completeness and intent.
Instruction Scope
SKILL.md instructs the agent/user to pass a Notion API token (or set NOTION_API_TOKEN) and to share databases with the integration. The runtime instructions and code interact only with Notion endpoints and CSV/JSON files, which is appropriate. However SKILL.md also mentions using OpenClaw secrets and templates that are not shipped; the instructions rely on an environment variable that the registry metadata did not declare. There are minor import/path assumptions (some examples use scripts.notion_client while code uses a top-level notion_client import) that could cause runtime confusion.
Install Mechanism
There is no install spec (instruction-only style) and requirements.txt lists only requests. No external downloads, unknown URLs, or archive extraction are used. This is low-risk from an install mechanism perspective.
Credentials
The package requires a Notion API token (NOTION_API_TOKEN) to operate — the code enforces this — but the registry metadata lists no required environment variables or primary credential. That mismatch is important: the skill will need a secret but the manifest doesn't declare it. No other unrelated credentials are requested, which is proportionate, but the omission from metadata and the ability to pass the token via arguments means users should be careful about how they provide the token.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no install-time persistence. It runs only when invoked and does not claim or require elevated platform privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-db-automation
  3. After installation, invoke the skill by name or use /notion-db-automation
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Notion database automation skill. - Automate querying, batch page creation, updating, and exporting Notion databases. - Supports all major Notion property types (including relations and rollups). - Includes scripts for bulk data import/export, template-based database setup, and common workflow automation. - Simple Python interface with ready-to-use examples and templates. - Designed for rapid workflow automation, backup, and analytics use cases.
Metadata
Slug notion-db-automation
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Notion Database Automation?

Automate common Notion database operations like batch page creation, data filtering, content generation, and export. Use when you need to automate workflows... It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.

How do I install Notion Database Automation?

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

Is Notion Database Automation free?

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

Which platforms does Notion Database Automation support?

Notion Database Automation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Notion Database Automation?

It is built and maintained by potatosolo (@potatosolo); the current version is v1.0.0.

💬 Comments