skills.rest
fred07diamond
fred07diamondCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion-integration

Sync documents bidirectionally between the content app and Notion pages.

Updated May 13, 2026
Search Tags:#documents#markdown#content management#integration#notion#sync#bidirectional
One-click install
npx skills add https://github.com/fred07diamond/Call-Copilot --skill notion-integration-fred07diamond
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-integration
Source: https://github.com/fred07diamond/Call-Copilot/tree/main/apps/content/.agents/skills/notion-integration
Command: npx skills add https://github.com/fred07diamond/Call-Copilot --skill notion-integration-fred07diamond

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping documents in sync between the content app and Notion requires manual copy-paste work and makes it hard to know which version is current. This Skill manages the full Notion sync lifecycle so documents stay linked and up to date. ## Core Features & Use Cases - Connection & Status Checks: Verify whether a Notion integration is connected and which workspace it belongs to before attempting any sync. - Linking & Syncing: Link local documents to Notion pages, pull Notion content into local documents as markdown, or push local markdown to Notion as blocks. - Sync State Tracking: Inspect the document_sync_links table to see sync state, last sync time, conflicts, and errors. - Use Case: A user asks "Is Notion connected?" then links a draft document to a Notion page and pushes the latest edits so the team sees the updated content in Notion. ## Quick Start Check whether Notion is connected, then link my current document to a Notion page and push the latest content to it.

Frequently Asked Questions about notion-integration

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

FAQPage Schema
How do I sync a document with Notion?▼

First link the local document to a Notion page using link-notion-page with the document ID and Notion page ID. Then use pull-notion-page to import Notion content or push-notion-page to send local content to Notion.

How do I check if my Notion integration is connected?▼

Run the connect-notion-status action. It returns whether a Notion integration is connected and which workspace it belongs to. Always check this before attempting any sync operations.

Does Notion sync merge changes from both sides automatically?▼

No, there is no automatic merge. Pulling overwrites local content with the Notion page content, and pushing overwrites the Notion page with local markdown. A has_conflict flag is set when both sides changed since the last sync.

What happens to formatting when pushing markdown to Notion?▼

The local document's markdown is converted to Notion blocks when pushed, replacing the Notion page's existing content. When pulling, Notion page content is converted back to markdown in the local document.

Why did my Notion sync fail?▼

Check the document_sync_links table for the state and last_error columns, which record sync failures. Common causes include a missing Notion API key in settings or an unlinked document, so verify connect-notion-status first.

Related Skills

Explore More Content & Communication Skills→
VegaStackVegaStack

notion-markdown-sync

Synchronize local markdown files with Notion pages bi-directionally.

Official
Advanced
potentialIncpotentialInc

content-calendar

Organize and schedule content publishing across channels with templates and review cycles.

Official
Intermediate
KiloforgeKiloforge
2

kf-conflict-resolver

Resolve git merge conflicts during push or pull sync operations.

Official
Advanced
KangOxfordKangOxford

notion-push-via-rest

Convert Markdown blocks into Notion blocks and create child pages via REST API.

Community
Advanced