BuilderIO/notion-integration
templates/content/.agents/skills/notion-integration/SKILL.md
How Notion sync works. Covers connecting, linking pages, pulling from Notion, pushing to Notion, and checking sync status.
$ install --global
skillsauthnpx skillsauth add BuilderIO/agent-native notion-integrationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:44 PM25.0s1 file scanned
SKILL.md
- name:
- notion-integration
- description:
- >-
Notion Integration
The content app can sync documents bidirectionally with Notion. Documents can be linked to Notion pages, pulled from Notion, or pushed to Notion.
Scripts
connect-notion-status
Check the Notion connection status.
pnpm action connect-notion-status
Returns whether a Notion integration is connected and which workspace it belongs to.
link-notion-page
Link a local document to a Notion page for syncing.
pnpm action link-notion-page --documentId abc123 --notionPageId notion-page-id
list-notion-links
List all documents that are linked to Notion pages.
pnpm action list-notion-links
pull-notion-page
Pull content from a linked Notion page into the local document.
pnpm action pull-notion-page --documentId abc123
This overwrites the local document's content with the Notion page's content, converted to markdown.
push-notion-page
Push local document content to the linked Notion page.
pnpm action push-notion-page --documentId abc123
This overwrites the Notion page's content with the local document's markdown, converted to Notion blocks.
Sync State
The document_sync_links table tracks sync relationships:
| Column | Description |
| ------------------------------ | ------------------------------------------ |
| document_id | Local document ID |
| provider | Always "notion" |
| remote_page_id | Notion page ID |
| state | "linked", "syncing", "error" |
| last_synced_at | Timestamp of last successful sync |
| has_conflict | Whether there's a merge conflict (0 or 1) |
| last_error | Error message if sync failed |
Common Tasks
| User says | What to do |
| ---------------------------------- | ----------------------------------------------------- |
| "Is Notion connected?" | connect-notion-status |
| "Link this doc to Notion" | link-notion-page --documentId ... --notionPageId ...|
| "Pull from Notion" | pull-notion-page --documentId ... |
| "Push to Notion" | push-notion-page --documentId ... |
| "Show Notion-linked documents" | list-notion-links |
Important Notes
- Notion sync requires a connected Notion integration (API key configured in settings)
- Pull overwrites local content; push overwrites Notion content — there is no automatic merge
- The
has_conflictflag is set when both sides have changed since last sync - Always check
connect-notion-statusbefore attempting sync operations
Related Skills
BuilderIO/booker
tools
VerifiedTrustedCommunity
Public booking flow — the state machine, animations, and URL/app-state sync.
108SKILL.mdUpdated Apr 19, 2026
BuilderIO/workflows
tools
VerifiedTrustedCommunity
Trigger-based automations — reminders, follow-ups, webhooks — across the booking lifecycle.
46SKILL.mdUpdated Apr 19, 2026
BuilderIO/team-scheduling
tools
VerifiedTrustedCommunity
Team event types, round-robin assignment, collective bookings, host weights, and no-show calibration.
46SKILL.mdUpdated Apr 19, 2026
BuilderIO/slot-engine
development
VerifiedTrustedCommunity
The pure `computeAvailableSlots` function — inputs, outputs, invariants, and debugging guide.
46SKILL.mdUpdated Apr 19, 2026