---
description: Push markdown content to Notion pages or databases
---

# Notion Writer

Push markdown content to Notion pages or databases via the Notion API.

## Triggers
- "write to Notion", "export to Notion", "노션에 쓰기"

## Capabilities

| Feature | Input | Output |
|---------|-------|--------|
| Page Content Append | Markdown + Page URL | Appended blocks |
| Page Content Replace | Markdown + Page URL | Replaced content |
| Database Row Create | Markdown + DB URL + Title | New database row |
| Connection Test | API token | Connection status |

## Environment
- `NOTION_TOKEN` / `NOTION_API_KEY` - Notion integration token (required)

## Scripts

```bash
cd ~/Projects/our-claude-skills/custom-skills/32-notion-writer/code/scripts

# Test connection
python notion_writer.py --test

# Page info
python notion_writer.py --page PAGE_URL --info

# Write to page (append)
python notion_writer.py --page PAGE_URL --file content.md

# Replace page content
python notion_writer.py --page PAGE_URL --file content.md --replace

# Create database row
python notion_writer.py --database DB_URL --title "New Entry" --file content.md

# From stdin
cat report.md | python notion_writer.py --page PAGE_URL --stdin
```

## Markdown Support

Headings, bulleted/numbered lists, to-do items, quotes, code blocks (with language), dividers, paragraphs.

## API Limits

| Limit | Value |
|-------|-------|
| Blocks per request | 100 |
| Text per block | 2,000 chars |
| Requests/sec | ~3 |

The script automatically batches large content.

## Source
Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/32-notion-writer/code/CLAUDE.md`