← Explore all 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.

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

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.

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 ↗
  1. Add https://mcp.notion.com/mcp and complete OAuth for the intended workspace.
  2. 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"
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. https://developers.notion.com/guides/mcp/get-started-with-mcp

    Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample

  2. https://developers.notion.com/guides/mcp/mcp-supported-tools

    Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample

Evidence & Ask