← Back to Skills Marketplace

Notion Mvp

Name: Notion Mvp
Author: luciorenovato

by luciorenovato · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

653

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install notion-mvp

Description

Create and list Notion tasks in a single database via Notion API. Use when the user asks to add tasks, list today tasks, or capture quick todos in Notion fro...

README (SKILL.md)

notion-mvp

Use this skill to write/read tasks across multiple Notion databases (aliases).

Required env vars

NOTION_TOKEN (integration token, secret_...)
one of:
- NOTION_DATABASE_MAP (JSON map alias -> database_id)
- NOTION_DATABASE_ID (fallback default database)

Example NOTION_DATABASE_MAP:

{"agenda":"db_id_1","tarefas":"db_id_2","crm":"db_id_3"}

Command wrapper

Run:

bash {baseDir}/scripts/notion_mvp.sh \x3Ccommand> [args]

Commands:

add \x3Calias> "\x3Cbloco>" [YYYY-MM-DD] [HH:MM] ["\x3Clocal>"] → create an item
- defaults: data=today, hora=09:00, local=""
today \x3Calias> → list items with Data = today
query \x3Calias> "\x3Ctext>" → search items by Bloco contains text
aliases → list configured aliases

Expected database properties

This skill expects these Notion properties in each target database:

Bloco (title)
Data (rich_text/text)
Hora (rich_text)
Local (rich_text)

Usage pattern

Validate env vars and fail with clear message if missing.
Resolve the correct database alias (agenda, tarefas, etc.).
For schedule capture requests, call add with alias + Bloco/Data/Hora/Local.
For “hoje” / “today” requests, call today \x3Calias>.
Return a concise summary after command output.

Examples

bash {baseDir}/scripts/notion_mvp.sh aliases
bash {baseDir}/scripts/notion_mvp.sh add agenda "Ligar para dermatologista" 2026-02-14 10:00 "Barra"
bash {baseDir}/scripts/notion_mvp.sh add tarefas "Consertar tela do celular" 2026-02-14 15:30 "Centro"
bash {baseDir}/scripts/notion_mvp.sh today agenda
bash {baseDir}/scripts/notion_mvp.sh query agenda "dermatologista"

Usage Guidance

This script is largely coherent with a Notion task helper: it needs an integration token (NOTION_TOKEN) and either a NOTION_DATABASE_MAP (alias->database_id JSON) or a NOTION_DATABASE_ID fallback. Before installing: (1) be aware the registry metadata incorrectly claims no env vars or required binaries — you must provide NOTION_TOKEN and database IDs and have curl and node available. (2) Create a dedicated Notion integration with the minimum scopes needed (read/write pages) and share only the intended database(s) with that integration — do not reuse a full-account token. (3) Review the script (already included) to confirm it only calls api.notion.com and does not access other files; it does not attempt exfiltration beyond requests to Notion. (4) If you want stronger assurance, ask the publisher to fix the registry metadata to declare NOTION_TOKEN and the DB map and to note required binaries (node, curl). If you cannot verify the origin of the skill or do not want to provide a Notion token, do not install.

Capability Analysis

Type: OpenClaw Skill Name: notion-mvp Version: 1.0.0 The skill is designed to interact with the Notion API for task management, requiring `NOTION_TOKEN` and Notion database IDs. The `SKILL.md` provides clear instructions for the AI agent and does not contain any prompt injection attempts. The `notion_mvp.sh` script uses `curl` to communicate with the Notion API and `node -e` for robust JSON parsing and construction, effectively preventing shell injection vulnerabilities. All sensitive inputs (like user-provided task details) are properly escaped and handled as data within JSON payloads. There is no evidence of data exfiltration to unauthorized endpoints, persistence mechanisms, or other malicious activities.

Capability Assessment

⚠ Purpose & Capability

The skill's stated purpose (create/list Notion tasks) matches the included script: it calls api.notion.com using a NOTION_TOKEN and database IDs. However the registry metadata claims no required env vars or binaries, while SKILL.md and scripts require NOTION_TOKEN and either NOTION_DATABASE_MAP or NOTION_DATABASE_ID and also rely on external binaries (node, curl). The missing declarations in metadata are a discrepancy.

✓ Instruction Scope

SKILL.md instructs the agent to run the bundled bash script which only uses NOTION_TOKEN, database IDs/map, and interacts with the Notion API. The runtime behavior is limited to querying Notion and constructing/creating pages; it does not read arbitrary files or other environment variables.

ℹ Install Mechanism

There is no install spec (instruction-only with an included script), so nothing is downloaded at install time. The script executes node and curl at runtime; the skill does not declare these required binaries in metadata, so the environment may be missing needed runtime dependencies.

⚠ Credentials

The environment variables used (NOTION_TOKEN, NOTION_DATABASE_MAP / NOTION_DATABASE_ID) are appropriate and proportional for a Notion integration. The concern is that the registry metadata lists no required credentials/env vars, so the skill's declared requirements do not match what it actually needs at runtime.

✓ Persistence & Privilege

The skill does not request persistent 'always' privilege, does not modify other skills or system-wide settings, and does not store new credentials itself. Autonomous invocation is allowed (platform default) but not combined with other high-risk factors.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install notion-mvp
After installation, invoke the skill by name or use /notion-mvp
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

notion-mvp 1.0.0 - Initial release. - Allows creating and listing Notion tasks in a chosen database using the Notion API. - Supports multiple database aliases for organizing tasks. - Provides commands to add tasks, list today’s tasks, and search by text. - Requires configuration of Notion API token and database mapping.

Metadata

Slug notion-mvp

Version 1.0.0

License —

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Notion Mvp?

Create and list Notion tasks in a single database via Notion API. Use when the user asks to add tasks, list today tasks, or capture quick todos in Notion fro... It is an AI Agent Skill for Claude Code / OpenClaw, with 653 downloads so far.

How do I install Notion Mvp?

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

Is Notion Mvp free?

Yes, Notion Mvp is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Notion Mvp support?

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

Who created Notion Mvp?

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

More Skills