← 返回 Skills 市场

Notion Mvp

Name: Notion Mvp
Author: luciorenovato

作者 luciorenovato · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

653

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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"

安全使用建议

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.

功能分析

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.

能力评估

⚠ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install notion-mvp
安装完成后，直接呼叫该 Skill 的名称或使用 /notion-mvp 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug notion-mvp

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 653 次。

如何安装 Notion Mvp？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install notion-mvp」即可一键安装，无需额外配置。

Notion Mvp 是免费的吗？

是的，Notion Mvp 完全免费（开源免费），可自由下载、安装和使用。

Notion Mvp 支持哪些平台？

Notion Mvp 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Notion Mvp？

由 luciorenovato（@luciorenovato）开发并维护，当前版本 v1.0.0。