Notion ToDo CRUD 工具 (mcp-notion-crud)

標題正規化：去除末端 (1) / (2) 序號、空白正規化、大小寫視為相同，因此 「整理並優化網頁部分內容與結構 (1)」與「整理並優化網頁部分內容與結構」會被視為同一組。

參數：

• dedupe_by：ToDo（預設，依標題）或 ToDo+專案（再加上專案串接，避免不同專案的同名項目被誤判）
• keep：oldest（預設保留最早建立）或 newest
• 篩選參數同 list：filter_status / filter_date / filter_due_date / filter_hours / filter_project / filter_assignee / keyword / filter_logic

典型流程：

1. find_duplicates(filter_date="2026-04-15")  → 取得 groups + all_delete_ids
2. 向使用者報告有哪幾組重複、將保留/刪除哪些
3. delete_batch(page_ids=all_delete_ids)       → preview（不帶 confirm）
4. delete_batch(page_ids=all_delete_ids, confirm=true)  → 實際封存

update — 更新單筆欄位

僅更新有傳入的欄位，未傳入的欄位維持原值。 定位方式（二擇一）：page_id（UUID）或 keyword（以名稱查找，僅匹配 1 筆時自動執行）。

update_batch — 條件式批次更新

依篩選條件查出多筆後，統一更新指定欄位。

• 篩選參數：filter_status、filter_date、filter_due_date、filter_assignee、filter_project、keyword、page_ids（JSON Array）
• 目標值參數：set_status、set_assignee、set_due_date、set_project
• 範例：將所有 04/15 的項目標記完成 → filter_date="2026-04-15", set_status="已完成"

delete — 封存單筆

將指定頁面設為 archived。 定位方式（二擇一）：page_id（UUID）或 keyword（以名稱查找，僅匹配 1 筆時自動執行）。

delete_batch — 條件式批次刪除（兩段式）

依篩選條件查出多筆後，逐筆封存。為避免誤刪，採用兩段式流程：

第一次呼叫（只帶 filter_*，不帶 confirm）→ 回傳 status: "preview" 與命中清單（含 page_ids），不會刪除任何資料。 第二次呼叫有兩種等效方式：

1. 帶 confirm=true + 相同的 filter_* 條件 → 以相同條件重查並執行
2. 直接帶 page_ids（從 preview 回傳取得）→ 跳過確認直接執行

• 篩選參數：filter_status、filter_date、filter_due_date、filter_hours、filter_assignee、filter_project、keyword、filter_logic（and / or，預設 and）
• 直接參數：page_ids（JSON Array，帶此參數視為已確認）
• 範例：刪除所有已完成項目 → filter_status="已完成" → preview → confirm=true
• 範例：刪除到期日是明天的 → filter_due_date="2026-04-17" → preview → confirm=true
• 範例：刪除 04/15 之前的項目 → filter_date="before:2026-04-15" → preview → confirm=true

參數前綴規則（避免混淆）

不同 action 對「到期日/狀態/負責人/專案」使用不同前綴，請嚴格依下表選用：

filter_* 前綴只用於篩選（list / update_batch / delete_batch 找出目標），絕不用於設定目標值。

❌ 錯誤範例

// 錯：把「設定新到期日」誤用為 filter
{"action": "update", "page_id": "xxx", "filter_due_date": "2026-04-17"}

// 錯：單筆 update 用了 update_batch 的 set_ 前綴
{"action": "update", "page_id": "xxx", "set_due_date": "2026-04-17"}

✅ 正確範例

// 單筆更新到期日
{"action": "update", "page_id": "xxx", "due_date": "2026-04-17"}

// 批次更新到期日（依條件篩選後統一設定）
{"action": "update_batch", "filter_date": "2026-04-15", "set_due_date": "2026-04-17"}

// 查詢到期日在某日前的項目
{"action": "list", "filter_due_date": "before:2026-04-17"}

註：為容錯，系統會在 create / update 收到 filter_* 或 set_* 前綴時自動映射為直接欄位值，但仍請依正確命名呼叫以免語意誤判。

篩選語法說明

環境變數需求

輸出格式

所有 action 統一回傳 JSON，含 status 和 action 欄位。