---
title: "Notion MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/notion/
description: "Searches and edits a Notion workspace through user-authorized remote tools, with plan-dependent access to connected-source search."
---

# Notion MCP: review, setup & limitations · Undominated.ai

> Searches and edits a Notion workspace through user-authorized remote tools, with plan-dependent access to connected-source search.

[← Explore all mcp servers](/mcp-servers/)

WORKSPACE KNOWLEDGE / Notion

# Notion MCP

Searches and edits a Notion workspace through user-authorized remote tools, with plan-dependent access to connected-source search.

 [See setup guidance ↓](#setup)[Original source ↗](https://developers.notion.com/guides/mcp/get-started-with-mcp)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 2 linked sources
 Publisher Notion
 Licence Not established
 [Read what was—and wasn’t—checked ↓](#review)

“Notion MCP provides tools for searching, reading, and changing content in your Notion workspace.”

 [Notion · upstream description ↗](https://developers.notion.com/guides/mcp/mcp-supported-tools) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The hosted service has current setup and tool-access documentation, unlike the older unmaintained adapter.
- The tool-access mechanism exposes plan/connection limitations before a client chooses a search or editing workflow.
- Notion’s setup page says the hosted MCP currently requires the OAuth authorization flow, and that non-interactive authorization for automated workflows is not available yet.
- The tools page says the same server can search, read, and change workspace content, while a download tool does not fetch arbitrary URLs or return binary files.

### A good fit for

 - Finding source pages and updating a project document in an authorized workspace.
- Connecting an interactive MCP client to a Notion workspace the user can already open
- Searching or editing Notion content when the client can complete OAuth and tolerate short rate-limit retries

### Weigh up before choosing

 - Interactive OAuth is currently required; unattended token-only automation is not supported by this hosted setup.
- Advanced filters or search features depend on the plan, and unsupported search options may be dropped with notices.
- Top-level private pages cannot be restored through Notion MCP yet; the page says to restore them from Trash in Notion.
- Rate-limit waits longer than 2 seconds are returned as a tool error instead of being waited out.
- No licence was stated on these pages, and none was inferred.
- This review did not execute the resource.
- The server was not called.
- An organization-shared connection acts through its connected account; do not assume every caller receives a separate Notion identity.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - https://developers.notion.com/guides/mcp/get-started-with-mcp (setup, access and capability sections)
- https://developers.notion.com/guides/mcp/mcp-supported-tools (setup, access and capability sections)
- https://developers.notion.com/guides/mcp/get-started-with-mcp
- https://developers.notion.com/guides/mcp/mcp-supported-tools
- Round 2 reread of acquired publisher setup and permission evidence; see immutable wave review.

### Our findings

 - The official FAQ explicitly distinguishes the maintained hosted server from the older open-source server.
- Read, create, update, comment and file-upload tools are documented; this is not a read-only knowledge connector.
- The get-started page says Notion MCP currently requires the OAuth authorization flow and that support for non-interactive authorization is still being worked on.
- The tools page says Notion MCP searches, reads, and changes workspace content, retries a rate limit only when the wait is 2 seconds or less, and otherwise returns that limit as a tool error.
- One download tool does not fetch arbitrary URLs or return binary files, and top-level workspace pages cannot be restored through Notion MCP yet.
- The setup guide distinguishes personal authentication from organization-wide clients that share a single authenticated connection.

### Not established by this review

 - Authentication, service availability and tool execution were not tested.
- The hosted implementation source and licence were not established.
- The resource was not executed and its tools were not called.
- The server was not called. A source review is not a runtime or security certification.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://developers.notion.com/guides/mcp/get-started-with-mcp)
 - Add https://mcp.notion.com/mcp and complete OAuth for the intended workspace.
- Check current tool access and search notices; choose only the page/content scope appropriate to the task.

### Before you start

 - A Notion account with access to the target content and an OAuth-capable MCP client.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "notion": {
 "url": "https://mcp.notion.com/mcp"
 }
 }
} Copy configuration ↗

### Compatibility

Claude Code · Codex · Cursor · VS Code · Antigravity · A client supporting the documented remote transport and authentication flow. · Configuration example follows the official Cursor/mcpServers syntax; other clients use different keys.

### Transports

Streamable HTTP · SSE

### Remote service / documented account access

 - Reads authorized workspace content and, when available, connected-source search results.
- Can create or edit pages, databases, comments and uploads within the granted access.

### Cost model

Notion plan, seat and AI/search entitlements determine available tools and limits.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Notion MCP official setup guide ↗](https://developers.notion.com/guides/mcp/get-started-with-mcp) Checked 2026-10-14 https://developers.notion.com/guides/mcp/get-started-with-mcp Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample
- [Notion MCP official documentation ↗](https://developers.notion.com/guides/mcp/mcp-supported-tools) Checked 2026-10-14 https://developers.notion.com/guides/mcp/mcp-supported-tools Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Atuin MCP ↗ Let an agent search your shell history and retrieve captured command output without executing those commands.](/mcp-servers/atuin/)[### Knowledge Graph Memory reference server ↗ Persist named entities, observations and relations in a local JSONL graph between client sessions.](/mcp-servers/memory/)[### Atlassian Rovo MCP ↗ Searches connected Atlassian work and lets an authorized client create or update work items and pages through the current Rovo MCP endpoint.](/mcp-servers/atlassian/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
