← Back to Skills Marketplace
miraclemin

Notion Publisher

by Miraclemin · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
45
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install notion-publisher
Description
Publish articles to Notion using cached local copies of the target database's default Notion template when available. Use this skill when the user types /not...
Usage Guidance
This skill mostly does what it claims: it bundles a Python CLI that talks to https://api.notion.com and uses local templates and a config directory (~/.notion_publish). Before installing or running it: 1) Be aware you'll need to provide a Notion integration token (NOTION_TOKEN) — the registry metadata does not declare this, so assume it's required. 2) The CLI will create ~/.notion_publish, write a JSON config, and can read/write ~/.notion_publish/.env — avoid storing secrets in plaintext there unless you accept the risk. 3) Inspect scripts/notion_publisher.py yourself (it is included) and confirm network calls point only to notion.com (they do in the bundled code). 4) If you want stricter isolation, run the CLI in a temporary/containerized environment or create a dedicated least-privileged Notion integration. 5) Ask the skill author or registry maintainer to update the skill metadata to declare NOTION_TOKEN as a required credential and to document exactly what gets stored locally (including any cache/overwrite behavior).
Capability Analysis
Type: OpenClaw Skill Name: notion-publisher Version: 1.0.0 The 'notion-publisher' skill is a legitimate tool designed to help users draft and publish articles to Notion databases. It includes a dependency-free Python script (scripts/notion_publisher.py) that interacts with the official Notion API and manages local configuration and secrets in a dedicated directory (~/.notion_publish/). The instructions in SKILL.md are detailed and focus on a logical workflow involving user confirmation, template selection, and image sourcing from reputable public APIs (e.g., NASA, Art Institute of Chicago). No evidence of data exfiltration, malicious code execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (publish articles to Notion) matches the included CLI and templates. However, the SKILL.md and bundled CLI explicitly require a NOTION_TOKEN for API calls while the skill registry metadata lists no required environment variables or primary credential — that is an inconsistency and should be declared.
Instruction Scope
Runtime instructions stay within the publishing workflow: choose a database, fetch schema, render templates, and call Notion APIs (or use MCP if available). The instructions do ask the agent to run shell commands (which is expected for a bundled CLI) and to read/write ~/.notion_publish config and ~/.notion_publish/.env. Those file operations are within the skill's stated purpose but broaden its access to the user's home directory.
Install Mechanism
No install spec — the skill is instruction + bundled Python script. The CLI is dependency-free and runs via python3; there are no downloads or external install URLs in the package, which keeps install risk low.
Credentials
The SKILL.md and scripts expect NOTION_TOKEN (and read a ~/.notion_publish/.env), yet the registry claims no required env vars or primary credential. Requiring a Notion integration token is reasonable for this functionality, but the omission from metadata is a mismatch that could mislead users about credential needs. The skill also writes files under ~/.notion_publish (config, optional cached templates, and .env), so users should be aware credentials may be stored locally if they follow the CLI guidance.
Persistence & Privilege
The skill creates and updates ~/.notion_publish/notion-publisher-config.json and may write ~/.notion_publish/.env and cached templates. always:false (not force-installed) and no cross-skill config changes are requested. Local persistence is expected for a publisher but the user should review what is stored (especially .env) before use.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-publisher
  3. After installation, invoke the skill by name or use /notion-publisher
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with MCP and CLI runtime support for Notion publishing.
Metadata
Slug notion-publisher
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Notion Publisher?

Publish articles to Notion using cached local copies of the target database's default Notion template when available. Use this skill when the user types /not... It is an AI Agent Skill for Claude Code / OpenClaw, with 45 downloads so far.

How do I install Notion Publisher?

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

Is Notion Publisher free?

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

Which platforms does Notion Publisher support?

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

Who created Notion Publisher?

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

💬 Comments