notion-connector

Execute policy-gated search, retrieval, and mutation actions on Notion pages, blocks, and databases.

10|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/narailabs/narai-primitives --skill notion-connector-narailabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-connector
Source: https://github.com/narailabs/narai-primitives/tree/main/plugins/notion-connector/skills/notion-connector
Command: npx skills add https://github.com/narailabs/narai-primitives --skill notion-connector-narailabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps users reliably access and update Notion workspaces for both reading and writing tasks without bypassing required safety checks.

Core Features & Use Cases

  • Notion Read Operations: Search workspace content, retrieve pages and databases, query database entries, and list attachments, attachments details, and comments for a page.
  • Notion Write Operations: Create and update pages and database entries, append or update blocks, and archive (delete-like) content while conforming to Notion’s constraints.
  • Policy-Gated Safety: Every action is evaluated by a policy gate before any Notion Public API call, with default escalation for write/delete actions and hard-denial for privilege actions.
  • Content Input Flexibility: Provide block objects directly or submit Markdown that is converted into Notion blocks for supported block types.

Quick Start

Use notion-connector to run a search over your workspace by providing an action and JSON parameters for the query, filter options, and result limits.

Frequently Asked Questions about notion-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Notion workspace content and retrieve database entries?

Notion workspace search executes by passing a search action and JSON parameters to query pages, databases, and retrieve specific database entries. You provide filter options and result limits to scope the returned content.

Can I create and update Notion pages using Markdown input?

Yes, Notion page creation and updates accept Markdown input, which is converted into supported Notion block types. You can also provide block objects directly to append or update content within existing pages.

How does policy gating work for Notion write and delete operations?

Policy gating evaluates every action before reaching the Notion API, applying default escalation for write and delete operations while hard-denying privilege actions. This ensures safety checks are enforced for all mutations.

What are the limitations when archiving Notion content and managing blocks?

Archiving content acts as a delete-like operation constrained by Notion's API limits. Block updates and creation conform to Notion's structural constraints, meaning unsupported block types in Markdown conversion will not process.

Does this approach work for retrieving Notion page attachments and comments?

Yes, retrieving Notion page details includes listing attachments, attachment details, and comments. You query a specific page to extract these associated elements alongside standard page content and database properties.

What is the best way to manage Notion database schemas and queries?

Managing Notion database queries involves passing specific action parameters to retrieve database entries and inspect schemas. This approach handles query filtering and schema retrieval directly through structured JSON parameters.