notion-sync

Synchronize Notion workspace content with an Obsidian vault via YAML configuration.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill notion-sync-maroffo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-sync
Source: https://github.com/maroffo/claude-forge/tree/main/skills/notion-sync
Command: npx skills add https://github.com/maroffo/claude-forge --skill notion-sync-maroffo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the synchronization of your Notion workspace with your Obsidian vault, including AI-powered summarization of long pages, reducing manual data transfer and keeping your knowledge base up-to-date.

Core Features & Use Cases

  • Bi-directional Sync: Pull pages and databases from Notion, push notes from Obsidian.
  • AI Summarization: Automatically generates summaries for Notion pages exceeding 2000 words.
  • Incremental Updates: Efficiently syncs changes without re-processing entire datasets.
  • Use Case: Keep your project documentation in Notion and your detailed notes in Obsidian in sync, ensuring all project stakeholders have access to the latest information and AI-generated overviews.

Quick Start

Use the notion-sync skill to pull all content from Notion into your Obsidian vault.

Frequently Asked Questions about notion-sync

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

FAQPage Schema
How do I sync Notion to Obsidian automatically?

Yes, this Skill supports bi-directional sync to pull Notion pages and databases into your Obsidian vault, and push Obsidian notes back to Notion. Configuration and incremental updates are managed through a YAML file.

Can I generate AI summaries for long Notion pages in Obsidian?

Yes, the Skill provides AI-driven summarization for lengthy documents. It automatically generates summaries for Notion pages exceeding 2000 words when pulling content into your Obsidian vault.

Does Notion to Obsidian sync require environment variables for authentication?

Yes, this Skill requires specific environment variables for authentication to access your Notion workspace. You must configure these credentials alongside the YAML configuration file before synchronizing.

How do incremental updates work when syncing Notion and Obsidian?

Incremental updates efficiently sync changes by processing only modified content rather than re-processing entire datasets. The Skill tracks modifications in your Notion workspace and Obsidian vault to update only altered files.

Do I need uv to sync Notion and Obsidian?

Yes, uv is a required dependency to run this Skill. It is needed to execute the underlying scripts that manage bi-directional content transfer and AI summarization between Notion and Obsidian.