Search across available knowledge
Search Notion; connected-source coverage depends on workspace configuration, plan and tool access.
Documentation ↗MCP server / productivity/knowledge / source-linked
Notion MCP
Notion MCP connects research, documentation and structured project pages to an agent. The useful distinction is search versus fetched evidence: inspect the actual page before relying on verification state, and check returned notices because unavailable search filters may be dropped rather than rejected.
Before you choose.
Identify the implementation and the job it supports.
Which implementation is this?
Notion-hosted MCP is the maintained product. The older open-source notion-mcp-server package is no longer actively maintained.
Implementation source ↗
Notion-hosted MCP is the maintained product. The older open-source notion-mcp-server package is no longer actively maintained.
Implementation source ↗
Notion MCP connects research, documentation and structured project pages to an agent. The useful distinction is search versus fetched evidence: inspect the actual page before relying on verification state, and check returned notices because unavailable search filters may be dropped rather than rejected.
Setup and connection.
The documented interface, authentication and installation path.
- Connection / transport
- Streamable HTTP; SSE fallback; stdio via a bridge
- Authentication
- Interactive OAuth authorization
Add https://mcp.notion.com/mcp as a remote server and authorize the intended workspace. Use a native HTTP client when possible; the hosted service needs no local Notion server.
Setup reference ↗Documented setup example. Review the source and credentials before running; this command was not executed for this article.
claude mcp add --transport http notion https://mcp.notion.com/mcpWhat it actually exposes.
Concrete capabilities with maintainer sources.
Fetch before making a claim
Use notion-fetch for a Notion result when its verification state matters; unified search results omit that detail.
Documentation ↗Maintain structured content
Create pages and databases and update accessible workspace content.
Documentation ↗Evidence and method.
What was checked and what was not tested.
HOW
Source method
Public maintainer documentation and repositories. This is not a hands-on product review.
WHEN
Last checked 2026-10-01
Setup examples are documented examples. Suggested trials and comparison advice are editorial guidance.
Sources support the adjacent factual statements. A source review does not establish uptime, performance, security or current account eligibility. Read the editorial policy.
Community signals.
Concrete reports from public community discussions, kept separate from product documentation.
Notion mcp experiences?
多位用户在 Claude Cowork、Claude Code 与 Codex 场景中反馈 Notion MCP 可用，尤其适合团队知识检索；Markdown endpoint 让内容读取更方便。但它仍不是本地 Markdown 库，访问速度有人觉得偏慢，也有人转向 notion-cli，认为速度、质量和限制更好。
“works great! the Notion API recently got a markdown endpoint.”Open community source ↗
Notion MCP gives me a lot of headache
用户在 Claude Desktop 中创建 Teamspace 页面时，初始写入成功但页面落在 Private 区域，随后 replace_content_range、移动、更新和基本 fetch 连续失败。另一位用户称手动 OAuth 设置稳定但功能极其有限。讨论把问题归因于限流、会话超时或临时配额。
“after approximately 10-15 successful operations, all subsequent Notion API calls started failing.”Open community source ↗
Community evidence is anecdotal and may reflect one setup, version or account. It is included for discovery and risk-sensing, not as a representative rating or independent benchmark. Verify the current official documentation before acting on a report.
Try a specific task.
A bounded evaluation you can reproduce in your own environment.
Proposed workflow: build a decision brief
Suggested evaluation, not an observed test result.
- Search for the project decision and identify candidate pages.
- Fetch the strongest matches and record status, date and conflicting statements.
- Prepare a new brief with links and unresolved questions; review before writing it back.
What to inspect: A sourced document with a visible evidence trail. This is a proposed workflow, not a hands-on result.
Workflow reference ↗Permissions and limitations.
Read these constraints before granting access.
Hosted MCP currently requires interactive OAuth; unattended initial authorization is not supported.
Boundary reference ↗Some unsupported filters are dropped with notices. Inspect notices to avoid presenting a broader result as an exact filtered answer.
Boundary reference ↗Decide by workflow.
Make the expected output explicit before you connect.
A sourced document with a visible evidence trail. This is a proposed workflow, not a hands-on result.
Keep the task inputs, tool calls, output and any errors together when you evaluate. The trial above is a proposal, not a recorded result.
Compare the alternatives.
Specific reasons to choose another route, with the tradeoff shown.
| Alternative | Choose it when | Tradeoff |
|---|---|---|
| Readwise MCP | Editorial choice: retrieve highlights and saved reading. | Optimized around a personal reading library. Documentation ↗ |
| Atlassian Rovo MCP | Editorial choice: work is governed in Jira and Confluence. | Use the existing Atlassian permission model and content. Documentation ↗ |
Questions before setup.
Answers specific to this implementation.
Does OAuth limit access to one page?
Do not assume that. The connected client can access content available to the authorizing user; review workspace controls.
Documentation ↗
Is the self-hosted package equivalent?
No. It uses older APIs and bearer-token authentication and is no longer actively maintained.
Documentation ↗