Notion Save Skill

Save content directly to your Notion database via the official Notion API with full Markdown support.

Features

• Markdown formatting: Headings, lists, tables, code blocks, bold/italic
• File input: Read content from .md files (recommended for long content)
• Auto-chunking: Handles content longer than Notion's block limits
• Inline formatting: Bold, italic, code, links are preserved

Usage

For long content (recommended): Use file input

# Write content to temp file first, then upload
python scripts/save_to_notion.py --title "Research Report" --file report.md --api-key "YOUR_KEY"

For short content: Use inline

python scripts/save_to_notion.py --title "Quick Note" --content "# Title\n- Item 1\n- Item 2" --api-key "YOUR_KEY"

List recent pages

python scripts/save_to_notion.py --list --api-key "YOUR_KEY"

Markdown Support

Element	Syntax	Notion Block Type
Heading 1	# Title	heading_1
Heading 2	## Title	heading_2
Heading 3	### Title	heading_3
Bullet list	- item	bulleted_list_item
Numbered list	1. item	numbered_list_item
Code block	```lang	code
Table	| col | col |	table
Quote	> text	quote
Divider	---	divider
Bold	**text**	annotation
Italic	*text*	annotation
Code	`text`	annotation
Link	[text](url)	link

Claude Usage Pattern

When saving long research reports or conversation content:

1. Write content to a temp markdown file
2. Call the script with --file parameter
3. Delete temp file after success

Example:

# In Claude's workflow:
# 1. Write content to temp file
with open('temp_report.md', 'w', encoding='utf-8') as f:
    f.write(markdown_content)

# 2. Call save script
python scripts/save_to_notion.py --title "Report Title" --file temp_report.md --api-key "KEY"

Configuration

• Default database ID: 2decc7dd-3404-8002-a7e7-d64733a75885
• API key can be passed via --api-key or NOTION_API_KEY env var

Error Handling

• 401 error: Invalid API key
• 404 error: Database not shared with integration
• Validation error: Check property names match database schema