Notion Release Notes

Per-tool access map in notion-fetch self

The notion-fetch MCP tool’s self response now includes a current_tool_access map, so clients can tell before making a call which tools will actually run on the connected workspace’s plan and which would only return an upgrade prompt. Each entry’s status is available, limited_free_trial (calls succeed via a free or metered trial allowance), upgrade_required (the entry also carries an upgrade_url into the workspace’s upgrade flow), or not_enabled. See Integrating your own MCP client.

New identity fields in OAuth token responses

User objects now include an email_verified boolean next to person.email, indicating whether Notion has verified that email address. The field appears anywhere person emails do, including the owner in OAuth token responses and List all users results.

Notion MCP token responses now include top-level user_id, workspace_id, and email_domain fields on successful authorization-code exchanges, so MCP clients can associate a connection with a Notion user and workspace without an extra call. See Integrating your own MCP client.

New response fields like these are backwards-compatible additions and appear on every API version. Parse responses leniently: ignore fields you don’t recognize rather than rejecting them.

Notion app links in API responses use the new app domain

As part of Notion’s move from notion.so to notion.com, the links Notion generates for its own records changed in early June 2026: the url values returned for pages, databases, and data sources, and the href values for page and database mentions, now point at the Notion app domain with a page path prefix, https://app.notion.com/p/{page-id}, instead of https://www.notion.so/{page-id}. Existing notion.so links continue to open correctly.

These values are links for people to open in Notion, not stable identifiers: their domain and path format may change again. To reference a record, use its id field rather than parsing the URL, and use a page’s public_url to link to its published site. Links authored by users, such as link.url in rich text and URL property values, and links to sites published on notion.site or custom domains are unchanged.

Search the trash and query archived pages

Search accepts a new filter.in_trash option to list trashed pages and data sources (databases on API versions before 2025-09-03).

Query a data source accepts a top-level is_archived body parameter to return archived pages instead of the default non-archived set.

SDK support: @notionhq/client v5.23.2 adds filter.in_trash support to client.search(). v5.23.1 exports rich text annotation types and fixes pagination helper type compatibility with endpoint methods under strictNullChecks.

You can now share your Notion Workers.

Build and iterate on Workers with your team. Or share one so teammates can connect it to their own Custom Agents. Picture a Salesforce Worker, built by a single teammate, now powering agents across your sales and marketing teams.

Can connect lets teammates use your Worker, while Full access lets them improve it or bring it to a new problem.

Get started from the Developer Portal via Settings → Connections → Go to developer portal, or visit app.notion.com/developers.

Verify webhook signatures with one call

The new verifyWebhookSignature() helper confirms that a webhook event really came from Notion, so you no longer need to hand-write the HMAC check. Pass the raw request body, the X-Notion-Signature header, and your subscription’s verification_token; the helper compares signatures in constant time and returns false instead of throwing on malformed input. It works without configuration in Node.js 18+, Bun, Deno, Cloudflare Workers, Vercel Edge Functions, and browsers. A companion signWebhookPayload() generates signatures for testing your handler.

Read every row in a large data source

A single data source query returns at most 10,000 results, so plain pagination can silently miss rows. The new iterateAllDataSourceRows() and collectAllDataSourceRows() helpers page past the limit using the windowing approach from the Query large data sources guide, de-duplicating rows along the way. Stream rows with the iterator, or collect them into an array when the full result fits in memory.

Start and poll async page writes

notion.asyncTasks.retrieve({ task_id }) adds typed support for the Retrieve an async task endpoint, and the page create and markdown update methods now accept allow_async: true. Together they let you run large markdown writes asynchronously: start the write without holding a request open, then poll until the task succeeds or fails.

Reliability and fixes

• The client now automatically retries service_overload (HTTP 529) responses, respecting the Retry-After header as described in Request limits. Thanks to @RyanBillard for contributing this.
• The relevance sort in search parameters now has the correct type, { property: "relevance" }.
• Pagination parameters accept start_cursor: null, so you can pass a response’s next_cursor straight through without a null check.

Choose an expiration when creating a personal access token

When creating a personal access token in the Developer portal, you can now pick an Expiration of 7 days, 30 days, 90 days, 180 days, or 1 year. The default stays at 1 year, matching the previous behavior. The create dialog previews the exact expiration date, and the reveal step shows the same date next to the token value.

The workspace admin view under Settings & members → Connections now also surfaces an Expired status and filter for PATs whose expiration has passed. Expired tokens stop authenticating and return an unauthorized error, and can still be revoked from the admin view or the Developer portal.

Your agents shouldn’t be stuck in one-off chats. Now you can bring multiple agents into a single UI with the rest of your team, so you can automate entire workflows end-to-end.

And there’s a lot more. AI Meeting Notes now include speaker labels (a top request!), your Notion Agents can read and write more filetypes like Excel and PowerPoint, and you can build interactive HTML blocks, like an ROI calculator.

Orchestrate External Agents (Claude, Cursor, and more soon)

Some of your agents might live in CLIs, IDEs, and separate apps, doing solo work the rest of the team can’t see or build on. Now you can assign them tasks from a board shared with your whole team, @-mention them like teammates, and watch them run.

Claude and Cursor are the first two External Agents in Notion. That means you can reimagine entire end-to-end processes with full automation, right alongside the rest of your team’s work.

Get started →

Smarter meeting summaries with speaker labels

AI Meeting Notes now identifies speakers in your meetings, based on whose microphone is active. This improves meeting summaries and makes sure follow-ups are assigned to the right teammate. And this is just the beginning; we’ll keep making speaker identification even better!

Download the desktop app for the best experience →

Add interactive HTML blocks to your Notion docs

Notion Agents can now create interactive HTML blocks, and we can’t stop tinkering with them. The best part is that they live in Notion, so anyone on your team can use them or iterate on them. Some examples we love:

• Build a ROI calculator: Watch your customers’ eyes light up when they see how much they’ll save by using your solution. Customize it with details like their industry or current tool stack.
• Quiz your teammates: Turn a doc about your latest feature into an interactive quiz your team will remember. Your Agent will identify what matters, create relevant questions, and score results at the end.
• Map your org chart: Visualize your people database as an org chart so new hires onboard faster and cross-functional work gets done. Do it directly in Notion, with no need to open another tool.

Try it out →

Your Notion Agents now speak Microsoft

Your Notion Agents now work with PPTX, XLSX, DOCX, and more. Give your agents context by attaching spreadsheets, decks, Word docs, and PDFs—your agent reads them like any other source.

And your agents can create these files for you too: turn a page into a polished PowerPoint, spin a database into an Excel model, or summarize a pile of PDFs into one clean doc. Your legal and finance teams will thank you. Notion 🤝 Microsoft.

Your agent can use Outlook for you

Another nice one for our Microsoft shops. Connect Outlook Mail and Calendar and your Notion Agents can run your inbox and your schedule for you. Triage incoming email, draft replies in your voice, and send messages; all you have to do is ask.

Your agent can find open times, schedule meetings, and keep your calendar in order so you spend less time wrangling logistics and more time on the work that matters.

Five new MCP connections for Custom Agents

Five new MCP connections for Custom Agents

People are loving Notion MCP—usage has 10×’d in the past month. Now your Custom Agents get five more connections out of the box: Mercury, Mixpanel, Miro, Box, and ClickHouse.

They join the connections already available (like Figma, GitHub, Zapier), so your agents can pull financial data from Mercury, dig into product analytics in Mixpanel, or update a Miro board, all with no custom setup required. Find and connect every available integration from the new connections tab in your settings.

Learn more →

More models, without the lock-in

Your agents support a fresh lineup of new models, so you can pick the right brain for the job, whether you need speed, deeper reasoning, or a creative spark. Use the latest frontier intelligence from Opus 4.8 or Grok 4.3, or choose a more cost-efficient model like the new open-weight GLM 5.2.

Track Custom Agent actions in the audit log

Your security team now gets more visibility into how AI is being used. The audit log includes Custom Agent activity, so you can see when an agent runs, what it changed, and who triggered it, making it easier to review workflows, troubleshoot issues, and stay compliant. Available on Enterprise.

And a few more …

• Custom Agents for Slack Enterprise Grid: Custom Agents now work across your full Slack org. Talk to your sales rep or learn more.
• Notion Workers in the credit dashboard: Find Worker usage in the Notion credits dashboard, so admins can track everything in one place. Learn more →
• Build Notion Workers on Windows: Windows developers, you’re in. The Notion CLI now installs on Windows through npm, so building and deploying Notion Workers is no longer limited to Mac and Linux. Read the docs →
• Upload audio to AI Meeting Notes: Bring meetings recorded elsewhere into Notion. Upload an audio file and AI Meeting Notes will transcribe and summarize it like any other meeting.
• Duplicate custom agents: Found a setup that works? Copy any custom agent in a click and tweak it for a new team or use case—no need to rebuild from scratch.
• Agents can use your people directory: Now you can give your agents access to your people directory, so they have more context about your team. Learn more →

Async page markdown writes

You can now opt into async responses for large page markdown create and update requests. Set allow_async: true when creating a page with POST /v1/pages and the markdown body parameter, or when updating page content with PATCH /v1/pages/:page_id/markdown. Notion returns an async_task handle with status_url and poll_after_seconds, which you can poll until the task succeeds or fails.

Notion MCP also supports async page create and update flows through allow_async: true on notion-create-pages and notion-update-page, plus the notion-get-async-task polling tool. See Working with markdown content for examples.