apiwatch

All changes / Notion MCP

Silent mcp

notion-fetch page markdown now cites files in page blocks by notion-file-block:// references instead of signed URLs, unless include_file_urls is true

Took effect · MCP tool notion-fetch (fetch for OpenAI clients) — file links in page markdown

Reviewed against the vendor source on Nov 3, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

Page markdown from notion-fetch in Notion MCP now cites files in page blocks by stable notion-file-block:// references and doesn't sign them. Files in database properties are still signed inline. include_file_urls defaults to false; passing include_file_urls true returns a references map from each reference to a signed URL (for ChatGPT connections, fetch puts it in metadata.references). The new notion-get-file-download-urls tool takes up to 25 references and returns files with reference, url, and expiry_time, plus unresolved references with a reason; those URLs expire after a few minutes. Code that read download links straight out of fetched page markdown now gets references, with no error.

Silent: No error. Behavior, results, or cost change quietly.

What to do

Where you need file downloads from fetched page markdown, pass include_file_urls true to notion-fetch and read the references map, or call notion-get-file-download-urls with up to 25 notion-file-block:// references copied exactly from the markdown. URLs from notion-get-file-download-urls expire after a few minutes, so request fresh ones when needed. When you edit or copy page markdown, keep the notion-file-block:// references, not the signed URLs.

Strings to search for

notion-fetch

Counts only in files that mention notion.

Source

https://developers.notion.com/page/changelog