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.
- 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"
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://developers.notion.com/guides/mcp/get-started-with-mcp
Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample
https://developers.notion.com/guides/mcp/mcp-supported-tools
Supports: summary, whySelected, bestFor, limitations, review, compatibility, install, access, transports, configExample