notion_skill

Overview

This skill integrates Notion through the AtrisOS API to search, read, create, update, and manage pages, databases, blocks, and comments. It provides programmatic workflows for common Notion tasks like querying databases, creating pages with blocks, appending content, and managing comments. Use it when you need automated access to your Notion workspace via AtrisOS.

How this skill works

The skill calls AtrisOS endpoints that proxy Notion API actions and uses a local Atris token for authentication. Before any operation it requires a bootstrap/check step to ensure the CLI is installed, a valid local token exists, and the Notion integration is connected. Requests include search, pages, databases, blocks, users, and comments endpoints and follow Notion semantics (pages are collections of blocks; database rows are pages with properties).

When to use it

• Search your Notion workspace for pages or databases shared with the Atris integration
• Read page metadata and full block content for display or summarization
• Create new pages or add rows to a database with matching properties
• Append, update, or delete blocks inside a page
• Manage comments and reply to discussions on a page

Best practices

• Always run the bootstrap step first to verify Atris CLI and connection status
• Check the database schema before creating rows so property names and types match
• Share only the pages or databases you want the Atris integration to access
• Use page IDs from search results or URLs (UUID format) to avoid lookup errors
• Handle API errors like object_not_found, validation_error, and unauthorized by re-authenticating or sharing resources

Example use cases

• Search for "meeting notes" across pages and databases, then display titles and last-edited timestamps
• Create a project brief page with a heading, paragraph, and bullet list in one request
• Query a task database for items where Status = "In Progress" and sort by created date
• Append an update paragraph to an existing page after a team meeting
• Add or reply to comments on a page to record review feedback