← Back to Skills Marketplace
tomas-mikula

Notion Manager

by Tomas Mikula · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
365
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install notion-manager
Description
Production-ready Notion API client for SaaS workflows. Create/read/update pages, query data sources, append blocks.
Usage Guidance
Do not install or use this skill in production until the inconsistencies are resolved. Specific issues to address: 1) Credential handling: SKILL.md advertises NOTION_API_KEY (env) but the code expects an auth object (params.auth.notionApiKey). Decide which method to use and document it clearly. 2) Authorization header bug: the code builds Authorization as `Bearer ${{key}}` which will stringify an object and send an invalid header; it should be `Bearer ${key}`. 3) Parameter naming: normalize param names between docs and code (camelCase vs snake_case) so the agent sends the correct fields. 4) Test behavior: verify fetch is available in the runtime, and confirm all endpoints/HTTP methods match Notion's current API. 5) Source verification: the skill's source/homepage is inconsistent (SKILL.md lists a web URL but registry lists none and owner is unknown); prefer skills from known authors or inspect and run in an isolated environment. After these fixes, the skill would be coherent and more trustworthy.
Capability Analysis
Type: OpenClaw Skill Name: notion-manager Version: 1.0.0 The skill is a standard Notion API wrapper designed to perform CRUD operations on pages and data sources. While it contains implementation errors in skill.js (specifically, the use of '${{key}}' and '${{op}}' inside template literals which will result in '[object Object]' strings), these appear to be unintentional coding mistakes rather than malicious intent. All network requests are directed to the official Notion API (api.notion.com), and there is no evidence of data exfiltration, prompt injection, or unauthorized access.
Capability Assessment
Purpose & Capability
The code and SKILL.md both implement Notion API operations (search, getPage, queryDataSource, createPage, etc.), which matches the stated purpose. However there are naming mismatches (SKILL.md mentions NOTION_API_KEY env and camelCase param names like dataSourceId, while code expects auth.notionApiKey and snake_case params). The package name/slug mismatch is minor but inconsistent.
Instruction Scope
SKILL.md declares NOTION_API_KEY as an environment credential and primary credential, but the runtime code does not read process.env; instead it expects params.auth.notionApiKey. The instructions and code disagree about where the API key must be provided. Parameter names in examples (dataSourceId, block_id vs blockId) are inconsistent with code, increasing the chance the agent will send malformed or unintended requests.
Install Mechanism
This is an instruction-only skill with a small code file and no install spec. Nothing is downloaded from external or untrusted URLs and package.json is minimal. No install mechanism risks detected.
Credentials
The skill only needs a Notion API key in scope, which would be proportionate. However SKILL.md states an env var (NOTION_API_KEY) while the code requires auth.notionApiKey in the input object; the registry metadata lists no required env vars. This mismatch could lead users to supply credentials in the wrong place or to accidentally expose secrets when trying to adapt the skill. No unrelated credentials are requested.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no install-time persistence. It makes outbound HTTP calls only to api.notion.com. Autonomous invocation is enabled by default (normal), but combined with other incoherences this increases risk of unintended API calls.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-manager
  3. After installation, invoke the skill by name or use /notion-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of notion-manager. - Production-ready Notion API client for SaaS workflows. - Supports creating, reading, and updating Notion pages, querying data sources, and appending blocks. - Simple authentication with NOTION_API_KEY. - Structured input/output schemas for consistent API interaction. - Ready-to-use operations: search, getPage, queryDataSource, createPage, updatePage, appendBlocks, createDataSource.
Metadata
Slug notion-manager
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Notion Manager?

Production-ready Notion API client for SaaS workflows. Create/read/update pages, query data sources, append blocks. It is an AI Agent Skill for Claude Code / OpenClaw, with 365 downloads so far.

How do I install Notion Manager?

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

Is Notion Manager free?

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

Which platforms does Notion Manager support?

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

Who created Notion Manager?

It is built and maintained by Tomas Mikula (@tomas-mikula); the current version is v1.0.0.

💬 Comments