notion-provider

Load Notion provider configs, validate fields, and auto-repair schemas.

3|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/kazukinagata/waggle --skill notion-provider
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-provider
Source: https://github.com/kazukinagata/waggle/tree/main/providers/notion/skills/notion-provider
Command: npx skills add https://github.com/kazukinagata/waggle --skill notion-provider

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

Notion provider integration for Waggle enables seamless coordination between Waggle tasks and Notion databases, ensuring data flows between Notion and Waggle with proper config handling, schema validation, and task orchestration.

Core Features & Use Cases

  • Notion-based provider for Waggle: loads provider config from Notion pages or local cache, validates core fields, and auto-repairs missing schema definitions.
  • MCP tool integration: uses notion-create-pages, notion-update-page, notion-fetch and related scripts to manage tasks, queries, and comments.
  • Identity and team resolution: resolves current user, matches team membership, and looks up workspace members for access control.
  • Ingestion, deletion, and view-server integration: updates tasks, archives pages, and pushes updated task data to the local view server.

Quick Start

Load the Notion provider when Notion is the active provider and run the Waggle setup to configure databases and start ingesting tasks.

Frequently Asked Questions about notion-provider

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

FAQPage Schema
How do I use Notion as a data source for task automation and execution metadata?

Notion integration lets you use Notion as a data source for tasks, configurations, and execution metadata. It loads provider config from Notion pages or local cache to coordinate task orchestration.

How does schema validation work when syncing Waggle tasks with a Notion database?

Schema validation checks core fields in your Notion database and automatically repairs missing schema definitions. This ensures data flows between Notion and Waggle with proper configuration handling.

Do I need jq installed to configure the Notion provider for Waggle?

Yes, jq is required as a dependency to run the Notion provider scripts. It processes JSON data structures used for loading headless_config and managing Notion API responses.

Can I manage Notion pages and archive tasks directly through Waggle commands?

You can manage Notion pages using notion-create-pages, notion-update-page, and notion-fetch scripts. The provider updates tasks, archives pages, and pushes updated task data to the local view server.

How do I resolve team membership and workspace members for Notion task access control?

The Notion provider resolves the current user identity, matches team membership, and looks up workspace members. This enables proper access control when dispatching tasks with Notion-backed storage.

What is the best way to auto-repair missing fields in a Notion-backed task configuration?

The provider performs core field validation and auto-repairs missing fields in Notion-backed configurations. It loads headless_config via notion-search or local cache to maintain schema integrity.