notion-im-helper

name	notion-im-helper
description	Sync IM messages to Notion via Notion API. Supports 7 content types, 4 formats, 2 metadata types. Append-only to a single Notion page.

Notion IM Helper

通过消息自动同步内容到 Notion。支持日记、笔记、待办、想法、问题、链接、摘抄 7 种类型。

Environment Variables

• NOTION_API_KEY - Notion Integration Token
• NOTION_PARENT_PAGE_ID - Target Notion Page ID (32 chars)
• NOTION_QUOTES_PAGE_ID (optional) - Separate page for quotes

Setup

1. pip install notion-client
2. Set env vars: NOTION_API_KEY and NOTION_PARENT_PAGE_ID
3. Authorize integration on Notion page (··· > Connect to)

Usage

When the user sends a message matching a trigger pattern, execute the corresponding script:

python scripts/record.py record --type {type} "{content}"
python scripts/record.py heading --level {1|2|3} "{text}"
python scripts/record.py divider
python scripts/record.py list --kind {bullet|number} "{items}"
python scripts/record.py toggle "{json}"
python scripts/record.py undo
python scripts/check_config.py
python scripts/daily_summary.py {daily|weekly|quote}

Trigger Rules

Content types (prefix → type):

• 日记: / 今天: / riji: / d → diary
• 笔记: / 学习: / note: / n → note
• 待办: / todo: / t → todo
• done: / 完成: / √ → done
• 想法: / 灵感: / idea: / flash: / 闪念: / i → idea
• 问题: / 疑问: / q: / q → question
• 摘抄: / quote: / qu: / z → quote
• 链接: / link: / url: / l → link

Formats:

• * text → H1 heading
• ** text → H2 heading
• *** text → H3 heading
• > text → quote block
• --- → divider
• - text → bulleted list
• 1. text → numbered list

Commands:

• 日报 / daily / 今日 / today → show today's records
• 周报 / weekly → weekly summary
• 摘抄 / 随机摘抄 → random historical entry
• 搜: xxx / search: xxx → search records by keyword
• 撤回 / undo → delete last block
• 配置检查 / check config → verify config

Smart detection (no prefix, AI infers):

• Pure URL → link
• Starts with YYYY-MM-DD → diary
• Contains [ ] → todo
• Default → idea

Output Protocol

Scripts emit standardized output prefixes:

• OK|message → success, relay success message to user
• ERROR|CONFIG → guide user to set up Notion integration
• ERROR|AUTH → invalid API key or page not authorized
• ERROR|RATE_LIMIT → tell user to wait
• ERROR|NETWORK → tell user to retry later

Always run check_config.py first on first use. Never modify or delete existing Notion blocks.