| name | notion-save |
| description | Save notes, ideas, and content directly to Notion database. Use when Claude needs to persist conversation insights, trading notes, research findings, or any content to Notion for later reference. Triggers on phrases like "save to notion", "记录到notion", "add to my notes database". |
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
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:
- Write content to a temp markdown file
- Call the script with
--file parameter
- Delete temp file after success
Example:
with open('temp_report.md', 'w', encoding='utf-8') as f:
f.write(markdown_content)
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
