notion-page-link-syntax

What problem does it solve?

Notion MCP URL validation errors occur when inserting links during updates, especially with braces-wrapped read URLs and unintended page moves.

Core Features & Use Cases

• URL normalization: Use plain URLs for write/update operations to avoid validation errors.
• Tag guidance: Choose between <page> (moves or creates a child) and <mention-page> (references without moving) to control page linking behavior.
• Practical examples: Convert a read URL wrapped in braces to a proper write URL and reference an existing page without altering page structure.

Quick Start

Provide a Notion page URL and specify whether to reference or move it to update content correctly.