Yes — Notion is free for personal use with unlimited pages and blocks. Team plans start at $10/member/month.

Notion AI is a built-in assistant that can write, summarize, translate, brainstorm, and extract action items directly in your workspace.

Can I use Notion for project management?

Yes — Notion databases support kanban boards, timelines, calendars, and table views for full project management.

Notion News

Control notifications from page writes

October 8, 2026

Page write endpoints now accept notifications.mode. Set it to silent to skip page update and @mention notifications for the change. Database automations, reminders, and connection webhooks still work as usual. See Create a page, Update a page, and Append block children for details.

Warnings from notion-update-page

October 7, 2026

notion-update-page now returns an optional warnings array, for direct and queued updates, when it changed or ignored part of the input, such as lines dropped for incorrect indentation or text auto-corrected to match the page. Each warning has a code and a message, and Markdown parser warnings also carry category and autofix. Each message is at most 500 characters; a longer one is cut and ends with a note giving its original length. A clean update has no warnings key; see Supported tools.

Status group filters beta

October 7, 2026

Status filters can now match a status group with status.group, for example every option in the "In progress" group. Before, a group that shared a name with an option, like the default "In progress", could only be matched as the option. Send Notion-Beta: status-group-filters-2026-10-06 to opt in. With the header, equals and does_not_equal match only option names, and views return saved group filters as group. Without it, nothing changes. See Status group filters beta.

One search tool in Notion MCP

October 7, 2026

Hosted Notion MCP sessions now list one content-search tool, notion-search (search for OpenAI clients). Its description matches the user's AI search access. It describes AI search when the user has it, and keyword search otherwise, with a one-line upgrade note when the plan lacks AI search. notion-ai-search no longer appears in tools/list, but it stays callable by name, so clients with a cached tool list keep working. Workspace-owned MCP connections, which have a selected tool list, keep the earlier tool list and descriptions. In the other sessions, the server instructions also tell clients to use the Notion search tool for every content search.

notion-get-tool-access is optional

October 7, 2026

Except on workspace-owned connections, tool descriptions no longer tell clients to call notion-get-tool-access before they use a tool. Tools apply access limits themselves and report them in their results. Call notion-get-tool-access only when you want plan or parameter details up front. This replaces the September 17, 2026 advice to call it first.

OpenAI's search and fetch shape for ChatGPT

October 7, 2026

For ChatGPT connections, a content search with search returns { results: [{ id, title, url }] } and fetch returns { id, title, text, url, metadata }, as both structuredContent and JSON text. This is the shape that OpenAI's MCP requirements set for company knowledge and deep research. ChatGPT search results no longer include highlights, path, timestamps, or notices. When fetch gets include_file_urls: true, file download URLs are under metadata.references. User lookups and other clients don't change; see Supported tools.

No more tool-specific Notion MCP rate limits

October 6, 2026

notion-search and notion-query-data-sources no longer have their own rate limits. Calls to these tools now count toward the standard request limits, like other Notion MCP tools. See Supported tools.

Create teamspace root pages with Notion MCP

October 6, 2026

notion-create-pages now supports creating pages directly in a teamspace with parent.teamspace_id. Use a user-backed connection with permission to add top-level pages; see Teamspace root pages for details and an example.

Preview: Notion-flavored Markdown with markdown_version

September 30, 2026

The markdown endpoints accept a new optional markdown_version parameter. Set it to v2 to read and write Notion-flavored Markdown. This is an opt-in preview: v1 (enhanced markdown) stays the default, and requests without the parameter work as before. v2 doesn't support include_transcript yet, and synchronous v2 updates return parser warnings. Sending markdown_version without markdown on POST /v1/pages or the comment endpoints returns a 400 validation_error. See Markdown versions and the Notion-flavored Markdown format reference.

Custom blocks in markdown

September 30, 2026

The markdown content API and Notion MCP now read custom blocks with inherited bindings as instead of . You can place existing definitions and preserve unchanged instances during page edits; see Working with markdown content. Definition creation remains in private alpha.

Completing the query tool update in Notion MCP

September 29, 2026

notion-query-database-view is no longer available. Call notion-query-data-sources instead, and pass the same view_url as {"data": {"mode": "view", "view_url": "..."}}. Calls to the old tool name now return a tool error that names this replacement.

Higher Notion MCP search and query limits

September 28, 2026

Notion MCP now allows 20 search calls and 20 data source query calls per connection every 10 seconds. Rate-limit tool errors also include their structured JSON in the text response for clients that read only text. See Supported tools.

Custom emoji icons are validated

September 25, 2026

A custom_emoji icon on a page, database, data source, or callout must now name a custom emoji in the integration's workspace. Otherwise the request returns a validation_error instead of saving an icon that reads back as null. See Emoji and icon. Notion MCP applies the same check to custom_emoji: page icons in notion-create-pages and notion-update-page.

Page writes return 504 when a request times out

September 24, 2026

Update a page's content as markdown and the notion-update-page MCP tool now return HTTP 504 gateway_timeout when a request runs past its deadline. Before, they returned HTTP 500 internal_server_error. The notion-create-pages and notion-convert-page-to-skill MCP tools already returned 504 in this case. A 504 does not mean the write was undone, so check whether the change was saved before you retry it. A write that runs out of its time budget still returns 503 service_unavailable, with additional_data.retry_guidance. See Request limits for when to retry each status.

Rate limit waits in the response body

September 24, 2026

Any 429 or 529 response that includes a Retry-After header now repeats the wait in the body as additional_data.retry_after, so clients that can't read headers, such as MCP clients, can still see how long to wait. Two new rate_limit_reason values identify an endpoint's own limit (public_api_endpoint_rate_limit) and a connection whose API access has been restricted (public_api_request_blocked). A workspace-limit 429 now says that the limit is shared by all of the workspace's connections. See Request limits.

Notion icon URLs are validated

September 23, 2026

An external icon URL that points at Notion's built-in icon set, such as https://www.notion.so/icons/pizza_blue.svg, sets a native icon and reads back as type: "icon". A URL that names no real icon or color now returns a validation_error instead of saving a broken icon. In Notion MCP, the page icon parameter on notion-create-pages and notion-update-page now accepts the icons/pizza_blue identifier that notion-fetch returns, so an icon can be copied from one page to another.

GPT-6 Luna and Sol Join Notion’s Model Picker

September 22, 2026

Notion is rolling out GPT-6 Luna and GPT-6 Sol as two additional choices in its model picker.

File uploads accept CAD and 3D model formats

September 22, 2026

The File Upload API now accepts common CAD and 3D model formats, including .dwg, .dxf, .dwf, .rvt, .rfa, .3dm, .step, .stl, .obj, and .glb. They attach to pages as file blocks.

application/octet-stream resolves from the file extension

September 22, 2026

Many HTTP clients label files with application/octet-stream when they can't infer a MIME type from the extension. Create a file upload and Send a file upload now treat that generic type as unspecified and resolve the real type from the filename extension, or from the content type set at creation. Files with unsupported extensions are still rejected.

GLM 5.3 and GLM 5.3 Flash in Notion Agents

September 19, 2026

Notion added the open-weight GLM 5.3 and GLM 5.3 Flash models to Personal and Custom Agents.

Check tool access with notion-get-tool-access

September 17, 2026

Notion MCP has a new notion-get-tool-access tool. Call it with {} to get the full connection-scoped current_tool_access map. It takes an optional tool_names array such as ["search", "ai_search"] to narrow the result. Call it before you use a tool whose availability depends on the plan: to choose between notion-search and notion-ai-search, for example, or to see which parameters the workspace's plan restricts. Those tools now say so in their descriptions, and each points to one call for the whole map that you can reuse across them. It doesn't grant access or change the workspace. Entries in the map can now include restricted_parameters, which maps a parameter path such as filters.title_only to the reason it's unavailable. A restriction applies even when the entry's status is available, so check it before sending the parameter. Read the reason against your requested value: a single teamspace remains supported even when filters.teamspace_ids lists a restriction on multiple teamspaces. When ai_search is exposed and available, the map omits search, even when requested by name. Otherwise, the map can include both an available search entry and an unavailable ai_search entry, depending on

Search drops unavailable options instead of failing

September 17, 2026

A notion-search or notion-ai-search call that asks for a filter or sort the workspace's plan doesn't include now runs the supported part of the search. These calls previously returned a validation_error. The response adds a notices array naming the dropped fields, with an upgrade link when available, and results can be broader than requested and use relevance sorting. On a plan without multiple-teamspace search, when teamspace_id and filters.teamspace_ids select different teamspaces, both are dropped. If dropping the options leaves an empty query with no supported constraint, the response returns no results and a notice asking for a non-empty query or a supported filter. notion-ai-search content search on a plan without AI access now runs a keyword search in Notion only rather than returning an upgrade error. It still reports type: "ai_search" and explains in notices that connected sources weren't searched. A workspace with a billing restriction, such as an unpaid invoice, still gets a permission error asking a workspace owner to manage billing.

notion-ai-search handles user lookup

September 17, 2026

notion-ai-search now takes query_type. Set it to user with a name or email to look up a workspace user, and the response reports type: "user_search", the same as notion-search. Omit query_type, or set it to internal, for a content search. Content filters and sorting aren't valid with a user lookup and return a validation_error. A user lookup doesn't need AI access, but both search tools need user information capabilities. Workspace-owned MCP connections must also expose notion-get-users. Choose an exposed search tool; switching tools doesn't bypass these permissions.

Introducing the Notion Skills API

September 17, 2026

Notion has introduced the Notion Skills API. Teams can edit their skills in Notion and use them in ChatGPT, Claude, and all of their agents. The API exposes skills stored as Notion pages as downloadable directories of files, following the Agent Skills and Agent Plugins standards.

DeepSeek V4.1 Flash Now Available in Notion Agents

September 17, 2026

A new open-weight model just landed in Notion: DeepSeek V4.1 Flash is now available in Personal and Custom Agents, alongside the existing model choices.

Set Default Agent Instructions for Your Entire Workspace

September 15, 2026

Notion now lets you set default agent instructions that apply across your entire workspace. The company describes the feature as house rules for your agents, so teams can define guidance once instead of repeating it for every individual agent.

Custom Agents Can Now Call Sub-Agents

September 15, 2026

Notion Custom Agents can now call sub-agents, each with its own instructions, context, access, and model. The primary agent can hand off focused work to other Custom Agents, then bring the results back together to finish the job.

Notion 3.7: Agent skills for your whole team

September 15, 2026

You know how some people are really good at prompting AI? Or they’ve figured out the best way to handle repetitive work? Now they can turn that know-how into a skill and level up the whole team. Skills are reusable instructions that teach AI how your team works. Like generating a monthly business review in your team’s format. Or critiquing your doc in the same way your boss would. They’re like team shortcuts for getting repetitive tasks done.

Notion Desktop waits before background refreshes

September 15, 2026

Notion Desktop can now wait until you are done working before applying background updates to an active tab. Visible refreshes dropped from 30%+ to under 3% on the new version, which should mean fewer interruptions and less lost work while reading, typing, uploading, or recording meeting transcripts.

Session URL shorthand for Custom Agent session tools

September 10, 2026

Notion MCP's Custom Agent session tools now accept the shorthand session:// and thread:// for session_url, resolving both in the connected workspace. The full form session:/// that session tools return still works, and a full URL whose workspace ID differs from the connected workspace still returns HTTP 400 validation_error.

Validation and conflict errors from Custom Agent session tools

September 10, 2026

Notion MCP's Custom Agent session tools now return HTTP 400 validation_error for malformed URLs, URLs for a resource other than a session, or full URLs naming another workspace, and notion-send-message-to-session returns a conflict error when the session already has a run in progress. Both cases previously returned a generic failure. Valid URLs for missing, inaccessible, or unsupported sessions return HTTP 404 object_not_found. Wait for the run to finish with notion-wait-session before sending another message.

AI search accepts filters, and notion-search routes content queries to it

September 10, 2026

notion-ai-search now accepts the exact filters and sort options that notion-search accepts, and it accepts an empty query for filter-only browsing. These options return Notion-only workspace results so the constraints are enforced exactly, and the response still reports type: "ai_search". Omit them to search Notion and connected sources together. Filtering by editor, last-edited date, multiple teamspaces, title only, or content status, and sorting by date, still require Business or Enterprise. User lookup remains on notion-search with query_type: "user". Content searches sent to notion-search now run AI search when the connection can use it. When notion-fetch with the id self reports current_tool_access.ai_search.status as available, a keyword content query sent to notion-search searches Notion and connected sources and reports type: "ai_search", so clients that haven't adopted notion-ai-search keep getting unified results. A call that passes an exact filter, an empty query, or a sort other than relevance stays on Notion workspace search. Routing respects the connection's tool list: a connection that can't use notion-ai-search keeps its content searches on workspace search, and the

AI Meeting Notes Can Draft Email Recaps

September 9, 2026

Notion AI Meeting Notes can now draft an email recap with attendees from your calendar already filled in. Give it a once-over and send without leaving Notion.

Control which AI models your agents can use

September 9, 2026

What’s on your team’s model roster? That’s up to you. With model controls, workspace owners can choose which AI models are available in Notion Agent and Custom Agents separately, and set a default model for Custom Agents. Keep costs predictable and support your compliance needs while your teams continue building.

Faster retries and plan-based rate limits

September 9, 2026

The per-connection rate limit is now enforced over a fixed 60-second window: 600 requests per minute on Business and Enterprise plans, and 180 requests per minute on all other plans. Retry-After for this limit never exceeds 60 seconds, down from up to 15 minutes, and per-connection 429 responses now also include the wait as additional_data.retry_after in the body. See Request limits.

Notion MCP splits keyword search and AI search

September 2, 2026

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

Page covers and icons in notion-fetch responses

September 2, 2026

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

September 2, 2026

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

September 2, 2026

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.

Free workspace block limits now apply to the REST API

September 1, 2026

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

September 1, 2026

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.

Capture ideas and draft content in Notion

August 31, 2026

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

August 31, 2026

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

August 31, 2026

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.

Ask your agent to suggest edits

August 28, 2026

Your agents can now propose changes instead of making them directly. Ask your agent to suggest edits, then move top to bottom to approve each one. It’s great when you need line-level changes, like a pass for grammar.

Custom Agents API in Public Beta

August 28, 2026

The Custom Agents API is in public beta, with a Notion Agent SDK for reaching Custom Agents from outside Notion. You can hold a conversation with one and read back previous chats, or trigger an agent from another app or workflow.

Fetch saved database views in Notion MCP

August 27, 2026

Notion MCP's notion-fetch now accepts view:// URLs to read saved view settings. Tool response text now names fetch instead of view, without changing page content.

Custom Agent session tools in Notion MCP

August 27, 2026

Notion MCP now supports finding and working with Custom Agent sessions. The new tools can query or search sessions, start a session, send a follow-up message, check or wait for its status, stop a run, and list or read session events. See Supported tools for the full tool list and examples.

Atomic batched content updates in Notion MCP

August 25, 2026

notion-update-page calls that use the update_content command now apply every content-changing replacement in the batch or none of them. Previously, when one old_str matched no page content and another one in the same call did, the matching replacements were saved and the call returned success — so a batch that removed content in one operation and reinserted it in another could drop that content. These calls now return a validation_error naming the old_str that wasn't found, and the page is left unchanged. Operations whose old_str and new_str are identical are ignored without checking for a match. See Supported tools for the tool's matching rules. old_str must also be a non-empty string. Empty values were previously ignored, which silently skipped the replacement; they now fail validation on both notion-update-page and Update a page's content as markdown.

Admin API reference for users and permission groups

August 24, 2026

The Admin API reference now covers listing workspace users and managing workspace permission groups and direct memberships. These endpoints require the new user:read, permission-group:read, and permission-group:write scopes and are available to eligible Enterprise organizations.

Notion Agent APIs in public beta

August 20, 2026

The Notion Agent APIs are now in public beta. Use sessions to start a chat with a Custom Agent, stream its reply, submit an action, and page through a session's event history, so you can bring Custom Agents into a Slack bot, an internal tool, or a mobile client. The quickstart walks through a first request end to end with a personal access token. The beta also covers managing Custom Agents programmatically: find the agents a token can reach with Query agents, read per-agent usage with Retrieve agent insights, and set credit limits, enable, disable, or delete agents — individually or in an asynchronous batch. If you built against the private alpha routes for agents, threads, messages, or chat, see Upgrading to public beta. The replacements take JSON request bodies instead of query parameters and return sessions and events instead of threads and messages. Migrate off the alpha routes by September 30, 2026.

Model selection, simplified

August 14, 2026

The model picker now leads with a shortlist of models made for your hardest tasks, and every model has a scorecard to compare speed, intelligence, and cost. Pin your favorites for easy access and dial up the effort when you need a more thorough answer.

JS SDK updates

August 13, 2026

@notionhq/client v5.25.1 fixes the isFullDataSource and isFullDatabase type guards, which previously accepted partial responses and narrowed them to the full type. Both now require the title field, the same structural check the other full-object guards use. isFullPageOrDataSource picks up the fix. v5.25.2 adds the does_not_equal condition to verification property filters in data source and database query request types, alongside the existing status condition.

More filters in Notion MCP view tools

August 13, 2026

The notion-create-view and notion-update-view tools now apply relation, person, status, created by, last edited by, unique ID, last visited, verification, and place filters. Previously, some calls succeeded but saved a view without the requested filter. Use a page URL or ID for relation filters and a user ID or "me" for person filters. Invalid values now return an error. See Supported tools for accepted values, and read the notion://docs/view-dsl-spec resource for the full configuration syntax. Verification filters now round-trip through view responses for both matching (status) and non-matching (does_not_equal) conditions. Data source queries accept the same conditions.

Updating the query tool list in Notion MCP

August 13, 2026

New tool-list responses no longer include notion-query-database-view. Use notion-query-data-sources with mode: "view" for saved views. Clients with a cached tool list can still call notion-query-database-view; those calls continue to work and return migration guidance. The current_tool_access map returned by notion-fetch with the id self no longer has a query_database_view entry, since the map describes the tools that a current tool list advertises. See Supported tools for the tool list.

Multi-source SQL on Business plans in Notion MCP

August 13, 2026

notion-query-data-sources SQL queries that span multiple data sources now work on Business plans with Notion AI, which previously required an Enterprise plan. SQL is unlimited on Business and Enterprise plans with Notion AI; other plans keep the metered single-data-source allowance, and saved-view mode stays free on every plan.

prop() references in formula property writes

August 12, 2026

Formula expressions submitted through Update a data source now store prop("Property Name") references exactly as written. Previously, the API accepted some expressions but silently rewrote them — most visibly, a reference to a unique ID property dropped the ID's prefix from computed values, and a prop() reference inside an array literal emptied the array. Expressions the API can't store now return a validation_error instead. Formulas saved before this fix keep their old stored expression until you resubmit the update. Formula properties created through the API also now keep their result type, so number formatting options stay available in Notion and other formulas can reference them with prop().

Readable formula expressions in data source schemas

August 12, 2026

Retrieve a data source now returns formula expressions using the same prop("Property Name") syntax you write. Expressions that can't be rendered faithfully in this syntax continue to use the internal property reference syntax.

Admin API reference for agents

August 12, 2026

The Admin API reference now covers the endpoints for managing agents in a workspace: credit usage and limits, permissions, status, creation policy, and workflow metadata.

Filter properties on page writes

August 12, 2026

Create a page and Update page properties now accept the same filter_properties query parameter as Retrieve a page. Pass the IDs of the properties you want, and the write response includes only those properties. This keeps responses small and fast for pages with many properties. SDK support: @notionhq/client v5.25.0 adds filter_properties to pages.create() and pages.update().

Reorganizing query tools in Notion MCP

August 10, 2026

Use notion-query-data-sources for both SQL queries and saved database views. To query a saved view, set mode to "view" and pass the same view_url. Existing notion-query-database-view calls continue to work and now include migration guidance. We plan to remove this older tool in a follow-up change.

Truncation metadata on notion-fetch

August 7, 2026

The notion-fetch MCP tool response now includes truncated, unknown_block_ids, and unknown_block_count when a page is large enough that some subtrees could not be loaded. unknown_block_ids lists up to 50 omitted subtree root IDs, and unknown_block_count reports the total number of omitted subtree roots. Pass a returned ID back to notion-fetch to retrieve that subtree directly; treat an object_not_found error on retry as a signal that the caller does not have access to the subtree.

JavaScript SDK 5.24.0

August 5, 2026

We released @notionhq/client v5.24.0. It adds client.blocks.meetingNotes.create() for creating a meeting note, typed unsupported formula and rollup values, and APIErrorCode.InvalidBeta for handling invalid_beta responses.

unsupported formula and rollup property values

August 5, 2026

The API can now return formula and rollup page property values and property item values with type set to "unsupported" and an empty unsupported object. This happens when a value depends on too many related pages or nested formulas and rollups. The response doesn't include a partial value. Treat the property as unavailable. Rollups still include the function field. To make the value available, reduce the number of related pages or simplify the nested formulas and rollups.

Custom Blocks Early Alpha for Developers

August 5, 2026

Notion is opening up an early alpha for custom blocks, a new Notion primitive for building interactive blocks that can read your workspaces and databases. Very early, very experimental, and the team wants to learn from what developers build with it.

Notion MCP supports MCP protocol version 2026-07-28

August 3, 2026

The Notion MCP Streamable HTTP endpoint at https://mcp.notion.com/mcp now supports MCP protocol version 2026-07-28. Existing MCP clients that negotiate the earlier 2025-era protocol on the same endpoint continue to work unchanged, so no client updates are required.

AI Meeting Notes can now trigger Custom Agents

July 31, 2026

Custom Agents can now run right after an AI Meeting Note is finished. No more need to manually update status trackers, post recaps to the project channel, or file tickets by hand.

High Contrast Mode

July 29, 2026

Notion's muted design can make content hard to read, so a new high contrast mode is here for anyone who needs more contrast. Text, icons, and borders are much easier to see.

Clearer per-tool access status

July 27, 2026

The current_tool_access status previously called limited_free_trial is now available_with_limit. The new name makes clear that a tool is available until the usage limit included with the workspace's plan is reached. This is a naming and description update only; it does not change tool availability or usage limits.

Fetch documentation resources with the fetch tool

July 27, 2026

The Notion MCP fetch tool now accepts notion://docs/* URIs (for example, notion://docs/enhanced-markdown-spec) and returns the same content as the MCP resource of the same URI. This gives MCP clients that cannot read MCP resources a way to load the specs referenced in tool descriptions.

Workers, now in your Notion credits dashboard

July 24, 2026

Now you can track your Workers’ usage in the credits dashboard, alongside your other spend.

Claude Opus 5 in Notion

July 24, 2026

A new model today: Claude Opus 5 is now available in Notion.

Notion as Code (Beta)

July 23, 2026

Now in beta: Notion as code. Define an entire workspace in TypeScript, teamspaces, databases, custom agents, all of it, then deploy it through the API. Build workspaces with coding agents, version-control your setup in git, and reproduce the same setup anywhere you need it.

Per-tool access map in notion-fetch self

July 17, 2026

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 calendar tools for your agent

July 16, 2026

Your agent just got new calendar tools to show and manage your schedule. Join calls, send invites, and find times that work for everyone— all from the chat.

Search the trash and query archived pages

July 15, 2026

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.

New identity fields in OAuth token responses

July 15, 2026

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

July 15, 2026

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.

Notion Agent Manages Your Inbox

July 15, 2026

It's a bad day to be a notification. Notion Agent can now manage your Inbox: from chat, it catches you up on what's important, then marks notifications read or archives them in bulk.

Longer-lived Notion MCP access tokens

July 14, 2026

Notion MCP access tokens now last about eight hours, up from one hour. Clients must continue to rely on the token response's expires_in value, but the longer lifetime reduces refresh frequency and makes connections more resilient to client-side refresh failures.

Open and Import Markdown Files

July 14, 2026

.md, meet Notion. You can now open Markdown files in Notion as a read-only preview, then import them as Notion pages, so notes and docs written in Markdown drop straight into your workspace.

Verify webhook signatures with one call

July 8, 2026

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

July 8, 2026

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

July 8, 2026

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

July 8, 2026

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.

Meet the Notion Agents iOS app

July 8, 2026

Find answers quickly from across your workspace or connected tools, capture ideas wherever they happen, or hand off tasks for your agents to finish by the time you get back to your desk.

Notion Agents iOS App

July 7, 2026

Meet the Notion Agents iOS app — a team of agents in your pocket. Send a voice note, a photo of a napkin sketch, or a question at 11pm, and it's handled before you're back at your desk.

HTML blocks via the API

July 3, 2026

You can now create HTML blocks with the API. Upload an .html file with the File Upload API and attach it to an embed block via embed.file_upload when appending block children, creating a page, or updating a block. The Notion app renders the file's contents interactively in a sandboxed iframe — the same HTML block the app creates with the /html command and that agents create through Notion MCP.

Choose an expiration when creating a personal access token

July 2, 2026

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.

Notion 3.6

July 2, 2026

Notion 3.6 is here — more ways to work with agents, clearer meeting notes, HTML blocks, better file support, and a handful of fixes to make everyday work feel smoother.

Icon names and database icons

July 1, 2026

When setting a native icon, name now also accepts the icon picker name, so values like "token" and "star circle" can set the same Notion icon. databases.retrieve now returns the icon set in the Notion UI, matching the icon surfaced by dataSources.retrieve.

Notion 3.6: External Agents, HTML blocks, and more

July 1, 2026

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.

HTML Block

July 1, 2026

Notion added a new HTML block — build interactive HTML right on your page. Ask AI to turn your content into interactive explainers, prototypes, diagrams, dashboards, or even a playable arcade, then share with your team to use and tinker together.

Agent Now Uses Outlook

June 30, 2026

Your Notion personal agent can now use Outlook — view, manage, and schedule events in calendar, and search, triage, and respond to emails in mail.

Winding Down Notion Mail

June 25, 2026

Notion is winding down the Notion Mail inbox across web, desktop, and iOS on September 22, going all in on agents to run your inbox — more than half of Notion Mail users already manage email without ever opening their inbox.

Delegate to Cursor from Notion

June 24, 2026

via Cursor

You can now delegate tasks to Cursor directly from Notion. Built on the Cursor SDK, every cloud agent runs on the same models, harness, and runtime that power Cursor — @-mention Cursor on any spec or assign it a task to open a PR your team can review.

External Agents: Claude + Cursor

June 24, 2026

Introducing External Agents in Notion — your favorite agents collaborate like teammates. Assign Claude and Cursor tasks from a board shared with your whole team, @-mention them, and watch them run.

Claude Fable 5 in Notion

June 9, 2026

Claude Fable 5 is now in Notion — the model to put behind your most complex custom agents and workers, setting new highs on Notion internal benchmarks for the hardest multi-step work. Available on Business and Enterprise plans.

Grok 4.3 + Grok Build 0.1

June 6, 2026

Grok 4.3 and Grok Build 0.1 are now available for Notion Agent and Custom Agents.

Migration to app.notion.com

June 6, 2026

Notion has finished migrating from notion.so to app.notion.com — same workspace, new home.

Gemini 3.5 Flash for Custom Agents

June 6, 2026

Gemini 3.5 Flash is now available for Custom Agents in Notion.

Outlook + Notion Agents

June 6, 2026

Connect Outlook Mail to Notion Agents (alpha) — find threads, draft replies, send, sort, and archive.

Claude Opus 4.8 in Notion

June 6, 2026

Claude Opus 4.8 is now available in Notion.

Snapshot Diffs in Version History

May 27, 2026

Version History now shows exactly what changed — text, images, tables, database properties — without playing spot-the-difference. Snapshot Diffs are live.

Merge cells in simple tables

May 26, 2026

Finally! Merge cells in simple tables.

Custom Agent Insights

May 21, 2026

No more guessing what your agents are up to. Custom Agent Insights makes every run fully visible — change a prompt or model and see if your agent got cheaper or smarter run by run, hunt down expensive runs and the patterns behind them, and pinpoint where a run broke (a tool call, a missing connection) so you can fix the root cause.

Notion Now in Italian

May 20, 2026

Ciao! Notion is now available in Italian. Finalmente!

3.5: Notion Developer Platform

May 13, 2026

Now you (and your coding agents) can write code to sync any data and build any agent tool, all running on our infrastructure. You can also bring your favorite agents into Notion (like Claude, Codex, Decagon, or ones you’ve built yourself). It turns Notion into one shared canvas with all your data, for your team and agents to work together.

Notion Developer Platform

May 13, 2026

Introducing the Notion Developer Platform — new building blocks to sync any data source, build any tool, and orchestrate any agent:
• Notion CLI (ntn) — Notion in your terminal
• Workers — run code on Notion's infra
• Database sync — pipe any data source into Notion
• Agent tools — build any workflow
• Webhook triggers — trigger Notion from any app
• External Agents API — bring any agent into Notion
• Notion Agents SDK — use Notion Agents anywhere
…plus a bunch of API improvements. Soon you won't need to be a developer to build on Notion — your agent will be one for you.

Markdown API

May 13, 2026

The #1 requested dev feature is shipped: Markdown API. Plus a recap of the last year of API/MCP improvements — Database views API, Personal Access Tokens, 91% more token-efficient Notion MCP, root page creation, database locks for read-only, database templates, AI Meeting Notes API, OAuth scoped to your workspace, and the new Developer Portal.

Grok Now an MCP Integration in Notion

May 8, 2026

Notion added Grok as an MCP integration — your timeline and your workspace in the same chat.

Plan Mode

May 7, 2026

When you ask your agent to make significant changes like rewriting pages or updating databases in bulk, results can drift off course if your intent is unclear. Plan Mode introduces a preliminary step where your agent asks clarifying questions and builds a detailed plan before acting. The result is fewer surprises and more confidence in complex, multi-step work.

New Custom Agent Directory

May 6, 2026

Custom Agents now have a dedicated place in your Library. Use the Custom Agent Directory to browse all your workspace’s agents, pin your favorites, and create new ones to automate your team's busywork 24/7.

Speaker Identification in AI Meeting Notes

May 6, 2026

Notion AI Meeting Notes can now identify who's speaking in 1:1s and video calls.

New Custom Agent controls for admins

May 5, 2026

Two months ago, we launched Custom Agents in beta. Since then, teams have created more than a million of them and honestly pushed them further than we expected! One theme from admins was consistent: as Custom Agents scaled, so did the need for more control and visibility. Your feedback shaped what we built next, so here’s what's new.

A new home on mobile

May 4, 2026

Navigating Notion on mobile just got easier with the new home tab. Now your home, chats, meetings, and inbox are just one swipe away.

Notion AI Mobile Widgets (TestFlight)

May 2, 2026

New Notion AI mobile widgets designed by Andrew Ashen — available in TestFlight beta now.

Notion Agent Manages Your Email

May 2, 2026

Your Notion Agent can now manage your email! Ask it to search your inbox, draft a reply, or unsubscribe from lists you keep meaning to leave. It puts in the hours, you get your afternoon back.

Add Custom Agents to private Slack channels

May 1, 2026

Custom Agents can now read and reply in private Slack channels.

Custom Agents in Slack Channels

April 29, 2026

Notion now lets you add Custom Agents to private Slack channels — invite them like any teammate, and they only see the channels you bring them into.

Mobile Homepage Refresh

April 28, 2026

Notion refreshed its mobile homepage — home, AI chats, meeting notes, and inbox are all one swipe away.

Agent Instructions & Skills

April 28, 2026

Today's lecture in the Custom Agent series — learn how to turn your repeated prompts into reusable skills, get consistent outputs, and make your Notion Agent feel tailored to you.

Rollups now as currency, percent, and more

April 27, 2026

Rollups now support number formatting (USD, EUR, percent, etc.) and decimal places. Show budget totals, conversion rates, and more in your rollups without any formula workarounds.

Rollup Number Formatting

April 27, 2026

Rollups now support number formatting (USD, EUR, percent, etc.) and decimal places. No more formatting via formulas — your budget rollups finally look like money.

Class Is in Session

April 27, 2026

Learn how to build your first Custom Agent, write clear instructions, and connect the right tools and triggers so it can handle repetitive work for you and your team.

Tomorrow's lesson? Agent Instructions and Skills!

GPT-5.5 in Notion

April 25, 2026

GPT-5.5 is now in Notion.

Autofill Agents (Renamed)

April 23, 2026

Database agents are back to being called Autofill. Basic for quick one-pass fills (Biz + Ent plans), Custom Agent for bigger stuff with workspace + web search and multi-step reasoning.

Custom Agent Directory

April 21, 2026

Your Library just got a new wing. The Custom Agent Directory is a full-page gallery for your and your workspace's custom agents. Browse, search, and manage them in one place. Go to Library → Agents tab.

Kimi K2.6 Now in Notion

April 21, 2026

Kimi K2.6 is now in Notion. The first open-weight model that plays like other top-tier models. Strong at tool use and carrying out tasks no matter how meticulous or ambiguous.

Image Gen is Here

April 21, 2026

If you can make a page, you can make a graphic for it too. Just hit /image and Notion handles the rest.

Mail & Calendar in One Tab

April 20, 2026

Mail and calendar connections now live in a single Settings tab. Once connected, Notion AI can schedule meetings and draft emails on your behalf across accounts.

Fresh Cover Art + AI Agent Permissions

April 18, 2026

New cover art from Texturelabs, Hudson River School, National Museum of Asian Art, and USDA Pomological Watercolors. Plus: add, remove, and edit page permissions for custom agents in the Notion AI app.

Opus 4.7 Now in Notion

April 18, 2026

Opus 4.7, Anthropic's most intelligent model, is now in Notion. A real step up for multi-step workflows — fewer tokens, about 3x fewer tool errors.

Mail & Calendar, now in your settings

April 17, 2026

Connect your calendar and inbox from a new dedicated tab in your settings.

Schedule meetings with Notion Agent

April 15, 2026

Notion Agent now shows your calendar to help you find available time with teammates. See a ranked list of choices, compare schedules, and book. All without leaving the chat.

Notion AI Agent Connects to Your Calendar

April 15, 2026

Notion connected its AI Agent to your calendar — it can now find meeting times, create and update events, and display a real grid view right in chat.

Notion 3.4, part 2

April 14, 2026

We launched Custom Agents a few weeks ago, and teams are building faster than we can keep up with. In Notion 3.4, your agents can take on even more of your day-to-day busywork.

Customize your tabs in databases

April 10, 2026

Keep your databases clean and easy to navigate by choosing how your tabs are displayed: Text and icon, Icon only, or Text only.

New page cover art from timeless collections

April 9, 2026

Choose page cover art from four new collections, sourced from museums and public archives.

Mute discussion replies

April 8, 2026

Keep your notifications clean by muting replies to discussions you no longer find relevant.

Voice input on desktop

April 6, 2026

Voice input for Notion AI is now on desktop. Whether you are dictating a longer prompt, or just prefer talking over typing, voice input makes it easier to get things done with your Agent.

Keep pages tidy with tabs

March 30, 2026

Tabs let you split a page into clean sections so you can keep related content together without a long vertical scroll.

Archive outdated pages to keep your workspace fresh

March 27, 2026

Archive lets you mark pages as outdated to keep your workspace clean and improve your search results.

Notion 3.4, part 1

March 26, 2026

This month, we have a champagne problem: our engineers are shipping faster than ever, which means Notion 3.4 has too much to cover in a single email. So let’s start with the fundamentals, like a new dashboard view for your databases, a completely redesigned sidebar (opt-in to try it out!), presentation mode that turns any doc into a slideshow, and a lot more.

Custom skills for Notion AI

March 20, 2026

Custom skills let you turn any repetitive AI task into an easily accessible command.

Notion Academy & certifications, in 6 new languages

March 19, 2026

Notion Academy videos and certification programs are now live in 6 new languages— Spanish, Portuguese, Japanese, Korean, French, and German.

Custom instructions for AI Meeting Notes

March 18, 2026

Custom instructions let you define exactly how AI Meeting Notes makes your summaries so they are as useful as possible after a meeting ends.

Search Salesforce accounts, leads, opportunities, and contacts in Notion

March 11, 2026

Notion AI can now search your Salesforce data (accounts, leads, opportunities, and contacts) right alongside everything else in your workspace.

Visualize progress with dashboard views

March 10, 2026

Dashboard views are a new database view for better visibility and context. This lets teams (and agents) easily assemble beautiful, glanceable overviews directly on top of their databases.

Generate images with Notion AI

March 9, 2026

Notion AI can now generate and edit images right on your page.

GPT-5.4 is now in Notion

March 6, 2026

GPT-5.4 is now available in Notion’s model picker.

New “can create pages” database permission

March 5, 2026

The new “can create pages” database permission lets users create new pages in a database, while still being restricted from viewing or editing other contents they should not have access to.

Run Custom Agents for less with MiniMax M2.5

March 3, 2026

Custom Agents now support MiniMax M2.5, an open weight model that’s up to 10x more cost-efficient for basic tasks.

Present any Notion page

March 2, 2026

Turn any Notion page into a fullscreen presentation.

Notion 3.3: Custom Agents

February 24, 2026

Big news today: Custom Agents are finally here! Give them a job, set a trigger or schedule, and they’ll get it done—24/7. They’re designed for teams and work across Notion, Slack, Mail, Calendar, and more. The work that used to require constant coordination now runs on its own.