notion-mvp

What This Skill Does

The notion-mvp skill is a powerful bridge between your chat interface and your Notion workspace. It provides an efficient command-line interface to read from and write to Notion databases. By mapping simple aliases (like 'agenda' or 'tarefas') to specific Notion Database IDs, it abstracts the complexity of the Notion API, allowing you to manage your schedule, capture quick to-dos, and query task statuses directly from your AI agent. It relies on a shell-based interaction layer, ensuring that task creation, listing, and filtering are performed against a standardized schema containing 'Bloco', 'Data', 'Hora', and 'Local' properties.

Installation

To integrate this skill, use the ClawHub manager. Run the following command in your terminal:

clawhub install openclaw/skills/skills/luciorenovato/notion-mvp

Once installed, you must configure your environment variables. Ensure NOTION_TOKEN is set with your integration secret. Furthermore, configure either NOTION_DATABASE_MAP (a JSON map linking aliases to database IDs) or a single NOTION_DATABASE_ID as a fallback default. Proper setup of these variables is mandatory for the skill to communicate successfully with your workspace.

Use Cases

This skill is perfect for users who want to minimize context switching between their messaging apps and Notion. Common use cases include:

• Capturing ad-hoc tasks during meetings or brainstorming sessions.
• Checking your daily agenda without leaving your chat window.
• Searching through your historical records for specific tasks using the 'query' function.
• Organizing tasks into distinct categories using different aliases for different projects or aspects of your life.

Example Prompts

1. "Add a task to my agenda: Pick up groceries at 5 PM today."
2. "Show me what I have on my task list for today."
3. "Search my agenda for any items related to 'dermatologista'."

Tips & Limitations

• Database Schema: Ensure your target Notion database has the four mandatory columns: 'Bloco' (Title), 'Data', 'Hora', and 'Local'. If these columns are missing, the script will fail to write data.
• Alias Management: Always run the aliases command if you forget your current mapping configuration.
• Date/Time Formats: When manually calling commands, stick to the YYYY-MM-DD and HH:MM formats to prevent API parsing errors.
• Security: Since this tool uses a Notion integration token, ensure your environment variables are stored securely and never exposed in public code repositories.