Notion changed its API changelog

===================================================================
--- before
+++ after
@@ -5,8 +5,50 @@
 > Use this file to discover all available pages before exploring further.
 
 Skip to main content
 
+September 2, 2026
+
+NOTION MCP SPLITS KEYWORD SEARCH AND AI SEARCH
+
+notion-search is now keyword-only. It matches short, specific terms in Notion and no longer searches connected apps like Slack, Google Drive, and Jira. Use it for content search only when notion-fetch with the id self reports that current_tool_access.ai_search.status is not available. It remains the tool for user lookup by name or email.Semantic search moved to a new notion-ai-search tool. Use it for every content search when current_tool_access.ai_search.status is available, including searches that include specific terms. It takes one concise natural-language query and searches sources connected to the workspace, such as Slack, Mail, and Calendar, when they are available to the caller. Using it requires Notion AI; without it, calls return a prompt with a recovery link, and notion-fetch with the id self reports ai_search in current_tool_access so clients can route to notion-search. notion-ai-search does not accept the exact filters, the sort options, or the user lookup that notion-search accepts.Clients that still send the old content_search_mode parameter on notion-search keep working: workspace_search behaves like notion-search, and ai_search behaves like notion-ai-search. The parameter is no longer advertised, so call the tool you want directly.
+
+PAGE COVERS AND ICONS IN NOTION-FETCH RESPONSES
+
+The notion-fetch MCP tool now returns cover and icon metadata for pages and database items. Both use the same shapes as the REST API, so clients can inspect the current cover or icon before deciding whether to replace it.
+
+RICH TEXT IN DATA SOURCE QUERIES
+
+The notion-query-data-sources MCP tool now supports mode: "rows" to keep rich text in data source results. This mode preserves mentions and link targets that SQL output can omit.
+
+TYPED DATABASES IN THE REST API
+
+Create a database now accepts an optional database_type of tasks, projects, or skills. Notion builds the database from its canonical schema and metadata for that type, so the result matches a database of that type created in the Notion app. database_type can’t be combined with initial_data_source, and when title is omitted the database is named after its type. See Typed databases for the properties each type creates. Database and data source objects now include a read-only database_type field.
+
+September 1, 2026
+
+FREE WORKSPACE BLOCK LIMITS NOW APPLY TO THE REST API
+
+Starting today, the REST API enforces the existing Free workspace block limit for internal connections and OAuth connections restricted to selected workspaces. This is not a new workspace limit. See Workspace block limits for the grace period, HTTP 403 response, and background template behavior.
+
+UPGRADE PROMPTS FOR CUSTOM AGENT TOOLS IN NOTION MCP
+
+Notion MCP’s Custom Agent tools — notion-list-agents, notion-search-agents, and the session tools — now return a prompt with a recovery link when the workspace doesn’t have access to Notion AI and Custom Agents. They previously returned a generic permission error with no recovery link. notion-fetch with the id self also reports these tools as upgrade_required with an upgrade_url, or as plan_required with a landing_page_url and landing_page_action when Notion routes the user through a plan landing page. Clients can use this status to route around unavailable tools before calling.Workspaces with a billing restriction, such as an unpaid invoice, are treated separately: the tools return a permission error that asks a workspace owner to manage billing, and current_tool_access reports them as not_enabled rather than upgrade_required.A connection that lacks the “View threads and interact with agents” capability does not advertise these tools and must reconnect or re-authorize.
+
+August 31, 2026
+
+CAPTURE IDEAS AND DRAFT CONTENT IN NOTION
+
+Your agent can now capture ideas and draft content in Notion without choosing where the page belongs first. The page starts as a private draft, so you can review it and organize it later.
+
+SAVE AND REUSE YOUR PREFERRED WORKFLOWS WITH NOTION SKILLS
+
+When you ask your AI to save a workflow you want to reuse, it can now create a Notion Skill or turn an existing page into one. Skills are reusable instructions stored as Notion pages that you own and can edit.When you ask for that workflow later, your AI can find the right Skill and read its instructions before starting.
+
+FIND THE RIGHT PAGE MORE EASILY
+
+Your AI can now narrow Notion searches by where a page lives, who created or edited it, when it changed, whether the title matches, and the page’s status. It can also sort results and look through up to 50 matches.Search results now show more context, including where a page lives and whether Notion has verified it. This helps your AI choose between similar or conflicting pages before reading the full content.Every plan includes filters for creator, creation date, and a single page, data source, or teamspace. On Business and Enterprise plans, your AI can also filter by editor, last-edited date, multiple teamspaces, title, or content status, and sort by date.
+
 August 27, 2026
 
 FETCH SAVED DATABASE VIEWS IN NOTION MCP