CC4E #4: Draft in Claude Code, Collaborate in Notion
Author: Hannah Stulberg | Published: 2026-01-27
Bridges the “collaboration gap” between drafting in Claude Code and getting team input via Notion’s MCP server.
The Problem
Claude Code is great for drafting, but work needs feedback from others. Copy-pasting into Google Docs creates version problems. Notion has an official MCP server; Google Docs does not (yet).
What MCP Enables
Once connected, Claude Code can:
- Push docs to Notion
- Pull edits back
- Pull collaborator comments (page-level, not inline)
- Keep versions in sync
- Pull existing Notion docs as context
Setup (~30 minutes)
- Ask Claude to add the Notion MCP server (project-level or global)
- Restart Claude Code
- Run
/mcp, complete OAuth flow to authenticate with Notion - Verify by asking Claude to search your workspace
Notion Workspace Setup
Create a database (table) to track synced documents with four properties:
- Title – document name
- Status – Draft / In Review / Final
- Local Path – path to local file
- Last Synced – date
The Sync Workflow
Golden rule: always compare before syncing, never overwrite blindly.
| Direction | Process |
|---|---|
| New doc to Notion | Draft locally, tell Claude to push. Full content push is fine for new docs |
| Update existing | Claude compares versions, shows diff, makes targeted updates only. Preserves collaborator comments and formatting |
| Pull from Notion | Claude compares, shows differences, you choose what to pull |
| Conflicts | Compare-first prompts identify conflicts. Review section by section, merge manually, or pull first then re-apply |
Comment limitation: Claude can read page-level comments (discussion thread at top) but NOT inline comments (text highlights). Workaround: ask collaborators to leave high-level feedback as page comments.
Custom Commands
Create /push-to-notion and /pull-from-notion slash commands in .claude/commands/ to encode all the sync logic. Key elements to verify:
- Search before creating (no duplicates)
- Fetch and compare (know what’s different before changing)
- Show the diff (user confirms before sync)
- Targeted updates (only change what’s different)
Document Your Setup
Add Notion config to your project’s CLAUDE.md (database URL, schema, workflow) so Claude remembers across sessions.
When to Use
- Good for: docs needing collaboration, review cycles, rich formatting
- Not ideal for: personal notes, throwaway drafts, real-time simultaneous editing