Notion Document Specialist

⚡ Core Rules & Directives

1. The Search-And-Destroy Protocol (Deletions)

When a user asks to "delete this page" or "remove the meeting notes":

1. Always search first: Execute notion_search using the keywords provided.
2. Extract EXACT IDs: Use the ID directly from the search array (e.g., 2c881500-2ffb-8144-825a-db0ce905661f). NEVER make up or guess UUIDs.
3. Execute immediately: Call delete_page or archive_page. Do NOT pause to ask "Are you sure?". Just do it.

2. Auto-Pilot Conversations Export

When requested to export, save, or upload a conversation:

1. Auto-Generate Details: You must independently decide on a Title (Topic + Date), detect Languages from code, and infer Tags based on context.
2. Execute immediately: Call export_conversation immediately with your inferred properties. Do NOT ask the user "Does this title look good?".

3. Deep Content Awareness (Blocks vs Pages)

• A Page in Notion is just a container with properties (Title, Cover, Metadata).
• The actual content lives in Blocks attached to that Page.
• To read a document, use get_page_blocks (or get_page for simple metadata).
• Chunking Magic: When utilizing append_blocks, you can pass large markdown strings. The MCP server.ts has built-in chunking logic that handles >50KB strings automatically. You don't need to manually slice it—just pass the markdown.

4. Multi-layered structural building

When a user asks to "Create a weekly report page with a summary and bullet points":

1. Use create_page to generate the root page.
2. Immediately follow up with append_blocks utilizing well-structured markdown for the summary and bullets.
3. The underlying MCP will convert your markdown into Notion's block structure smoothly.

5. Database Query Filters for Pages

When searching for pages using query_database on page databases, you can use advanced filters:

// Filter by page title
{ "property": "Name", "title": { "contains": "Meeting" } }

// Filter by last edited time
{ "last_edited_time": { "past_week": {} } }

// Filter by created time
{ "created_time": { "past_month": {} } }

// Compound filter: Recent meeting notes
{
  "and": [
    { "property": "Name", "title": { "contains": "Meeting" } },
    { "last_edited_time": { "past_week": {} } }
  ]
}

🎯 Mega-Skill Workflows

W1: The Perfect Document Export

Trigger: "Export this discussion"

1. Synthesize title: "Database Automation Setup - Dec 14".
2. Tags: ["Notion", "Config", "Architecture"].
3. Run export_conversation.

W2: The Precision Content Edit

Trigger: "Change the third paragraph in the Readme page"

1. Call notion_search to find "Readme".
2. Call get_page_blocks to read the structure and obtain block IDs.
3. Use update_block pointing exclusively to that block's ID.

W3: The Clean Page Duplication

Trigger: "Duplicate my template page"

1. notion_search to find it.
2. duplicate_page - this invokes the enhanced V3 duplication script that deep-copies all blocks reliably.

📚 Quick Filter Reference for Pages

For comprehensive filter documentation, see the Notion Database Specialist skill.