ingest-notion

Ingest Notion databases and page trees into vault markdown files.

31|20|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-notion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest-notion
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/ingest-notion
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion content often lives in external spaces and is not readily accessible for AI workflows. This skill pulls recent Notion pages or database entries into the vault as structured markdown to enable search, reasoning, and downstream processing.

Core Features & Use Cases

  • Ingests databases: pulls all entries with titles, last edited times, and body excerpts for quick reference.
  • Ingests page trees: traverses a page subtree to a configurable depth and stores results as markdown blocks.
  • Idempotent writes: re-runs on the same day overwrite to preserve a clean vault state.
  • Notion MCP integration: relies on a Notion MCP to fetch data and surface it in the vault.

Quick Start

Ingest a Notion database or page subtree by providing the ID and optional depth, then verify the vault file under External Inputs/Notion.

Frequently Asked Questions about ingest-notion

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

FAQPage Schema
How do I ingest Notion databases and pages into markdown?

You can ingest Notion databases and pages into markdown by providing a specific ID and an optional depth limit. The skill traverses the page subtree, extracts titles, timestamps, and body excerpts, then writes them as structured markdown blocks into your vault.

What is the best way to sync Notion content into a vault for AI workflows?

Syncing Notion content into a vault pulls external pages and database entries into structured markdown. This enables local search, reasoning, and downstream processing by attaching vault-frontmatter with source IDs and ingest metadata to each file.

Does Notion data ingestion require an MCP integration?

Yes, Notion data ingestion relies on a Notion MCP to fetch external data and surface it in the vault. The MCP integration handles the API communication, while the skill enforces root_kind rules and manages the resulting markdown file writes.

Can I control the traversal depth when pulling a Notion page tree?

Yes, you can control the traversal depth when pulling a Notion page tree by specifying an optional depth parameter. This limits how far the skill traverses down the page subtree, ensuring you only capture the necessary hierarchical structure.

Are re-runs of Notion ingestion idempotent to preserve vault state?

Yes, re-runs of Notion ingestion are idempotent to preserve a clean vault state. Re-running the ingestion on the same day overwrites existing files, preventing duplicates and ensuring your structured markdown remains synchronized with the source.

What limitations exist when capturing Notion structures into markdown?

Limitations when capturing Notion structures include enforced root_kind rules and strict depth limits on page tree traversal. The skill only extracts titles, last edited times, and body excerpts rather than full binary attachments or complex nested databases.