diff --git a/custom-skills/31-notion-organizer/code/CLAUDE.md b/custom-skills/31-notion-organizer/code/CLAUDE.md
index a64e338..010e7b4 100644
--- a/custom-skills/31-notion-organizer/code/CLAUDE.md
+++ b/custom-skills/31-notion-organizer/code/CLAUDE.md
@@ -28,9 +28,13 @@ python scripts/notion_search.py "AI agents" --json | jq '.[].id'
 # Constrain to specific databases
 python scripts/notion_search.py "MCP" --databases f8f19ede-32bd-43ac-9f60-0651f6f40afe
 
-# Property filter
+# Property filter (Notion's filter shape — passed verbatim to data_sources.query)
 python scripts/notion_search.py "MCP" --databases ID \
-  --filter '{"Status": "Done", "Topic": "AI"}'
+  --filter '{"property": "Status", "status": {"equals": "Done"}}'
+
+# Compound filter (and/or)
+python scripts/notion_search.py "MCP" --databases ID \
+  --filter '{"and": [{"property": "Status", "status": {"equals": "Done"}}, {"property": "Topic", "multi_select": {"contains": "AI"}}]}'
 
 # Fast mode (skip LLM stages)
 python scripts/notion_search.py "exact term" --no-rerank --no-expand
diff --git a/custom-skills/31-notion-organizer/commands/notion-search.md b/custom-skills/31-notion-organizer/commands/notion-search.md
index edc0abe..6e38f4c 100644
--- a/custom-skills/31-notion-organizer/commands/notion-search.md
+++ b/custom-skills/31-notion-organizer/commands/notion-search.md
@@ -19,7 +19,7 @@ python3 notion_search.py "$ARGUMENTS"
 - **Default browse mode** (terminal table): `notion-search "AI agents in 2026"`
 - **JSON for piping** (e.g. into the future notion-to-notebooklm push skill): `notion-search "AI agents" --json | jq '.[].id'`
 - **Constrain to specific databases**: `notion-search "MCP" --databases f8f19ede-32bd-43ac-9f60-0651f6f40afe`
-- **Property filter** (per-database mode): `notion-search "MCP" --databases ID --filter '{"Status": "Done"}'`
+- **Property filter** (per-database mode, Notion's native filter shape): `notion-search "MCP" --databases ID --filter '{"property": "Status", "status": {"equals": "Done"}}'`
 - **Fast mode (no LLM)**: `notion-search "exact phrase" --no-rerank --no-expand`
 
 ## Requirements