@apilium/notion

Notion integration skill for Mayros -- pages, databases, blocks via API.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/notion ~/.mayros/skills/notion

Or install via the Mayros CLI:

mayros skill install @apilium/notion

Configuration

Set the following environment variable:

| Variable | Description | Example | |----------|-------------|---------| | NOTION_API_KEY | Notion integration token | ntn_xxxxxxxxxxxx |

Creating a Notion integration

1. Go to https://www.notion.so/my-integrations
2. Click "New integration"
3. Name it (e.g., "Mayros Agent")
4. Select the workspace
5. Copy the Internal Integration Secret
6. Share the pages/databases you want the agent to access with the integration

Usage

Once configured, the agent can:

• Search: Find pages and databases across the workspace
• Read pages: Retrieve page properties and content blocks
• Create pages: Add new pages to databases or as sub-pages
• Update pages: Modify page properties
• Query databases: Filter and sort database entries
• Manage blocks: Append content blocks to pages

Example prompts

"Search my Notion workspace for meeting notes"
"Create a new task in the Tasks database with status 'To Do'"
"What are all the in-progress items in my project tracker?"
"Update the status of page 'Q1 Report' to 'Done'"
"Add a checklist to the onboarding page"

Semantic Predicates

| Predicate | Scope | Description | |-----------|-------|-------------| | notion:page_created | agent | Pages created by the agent | | notion:page_updated | agent | Pages modified by the agent | | notion:database_context | agent | Database summary for context enrichment |

Content Type Annotations

The skill annotates query results with the Notion object type:

• page -- A Notion page
• database -- A Notion database
• block -- A content block within a page

License

MIT