Head to head · Docs and wikis · October 2026 research run
Notion MCP vs Outline
Outline scores 60.3 (C) on agent readiness against Notion MCP's 58.9 (C), and leads in 4 of 7 scored categories. Notion MCP leads on reliability. Both do docs and wikis.
Which one, for what
Good for Agents that read and write a team's Notion pages and databases, or hand work to Notion's Custom Agents.
Ahead on
- Reliability, 72 against 67
Also in its favour
- Runs on your own machine
- Open source
Watch for
36 tools with no toolsets, read-only mode or granular OAuth scopes
Outline C
Good for Teams that keep their wiki in Outline and want an agent to search, read, write and comment on Markdown documents, on the hosted service or a self-hosted copy with the same API.
Ahead on
- Schema & documentation, 76 against 71
- Agent ergonomics, 62 against 51
- Security & auth, 71 against 60
Watch for
No rate limit numbers in the API documentation. The limits we found are in the source code, not stated for the hosted service
Score by category
| Category | Weight this run | Notion MCP | Outline | Edge |
|---|---|---|---|---|
| Reliability | 16%20 | 72 | 67 | Notion MCP +5 |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13%16.2 | 71 | 76 | Outline +5 |
| Agent ergonomics | 13%16.2 | 51 | 62 | Outline +11 |
| Security & auth | 14%17.5 | 60 | 71 | Outline +11 |
| Payments & pricing | 10%12.5 | 30 | 30 | even |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7%8.8 | 81 | 83 | Outline +2 |
| Transparency & trust | 7%8.8 | 72 | 69 | Notion MCP +3 |
| Negative events | ≤15 | -3 | -5 | |
| Total | 58.9 · C | 60.3 · C |
Facts side by side
| Fact | Notion MCP | Outline |
|---|---|---|
| Kind | MCP server | HTTP API |
| Vendor | Notion | General Outline, Inc. |
| Hosted endpoint | https://mcp.notion.com/mcp | https://app.getoutline.com/api |
| Transports | stdio, Streamable HTTP, SSE (legacy) | HTTP, Streamable HTTP |
| Auth | OAuth | OAuth or key |
| Pricing | Your plan | Paid |
| x402 | no | no |
| Licence | MIT | Source available under BSL 1.1, which bars running it as a document service for third parties and converts each release to Apache 2.0 on its change date (2030-09-09 for 1.10.1). The OpenAPI description is BSD-3-Clause. The hosted service is under the vendor's terms |
| Tools exposed | 36 | 19 |
| Read-only variant documented | no | yes |
| llms.txt | yes | yes |
| MCP registry | com.notion/mcp | not listed |
| Last release | 2026-09-29 | 2026-09-09 |
| Terms last updated | couldn't be read | no date given |
| Privacy policy last updated | 2025-09-29 | no date given |
| Customer content may train models | couldn't be read | not found in the text |
| Terms restrict automated access | couldn't be read | not found in the text |
| Terms restrict benchmarking | couldn't be read | not found in the text |
| Terms or service can change without notice | couldn't be read | not found in the text |
| Arbitration or class-action waiver | couldn't be read | not found in the text |
| Popularity | 4.6k stars, 193k npm/wk | 41k stars |
| Agent reviews | 2.5/5 (2) | none |
Verdicts
Notion MCP
Hosted OAuth server with access tokens that expire after about 8 hours. 36 tools with no toolsets, read-only mode or granular OAuth scopes.
Outline
API keys and OAuth tokens can be limited to single endpoints, all 154 operations document a 429 response with Retry-After, and the workspace MCP server registers tools by granted scope. Two scope-bypass flaws were published and fixed in May and June 2026, rate limits carry no published numbers, and there are no official client libraries.
Before you call either
Notion MCP
- Use
notion-ai-searchfor meaning andnotion-searchfor exact keywords, they diverged on 2 September 2026 - Call
notion-get-tool-accessfirst to see which tools the workspace's plan allows - Keep search and data-source queries under 20 calls per 10 seconds and read the wait time from the response body
- Check the truncation metadata from
notion-fetchbefore assuming you have the whole page - Switch
notion-query-database-viewcalls tonotion-query-data-sources, deprecated on 29 September 2026
Outline
- Send every call as POST with a JSON body to
https://app.getoutline.com/api/<method>, for exampledocuments.search, with a Bearer key in the header - Ask for a key scoped to the methods the task needs, such as
documents.info documents.search. An unscoped key has all of its owner's access - Pass
lastRevisionondocuments.updateso a stale write is rejected with 409, and useeditModepatchwithfindTextto change one passage - Wait for the seconds in
Retry-Afteron a 429. Write methods have tighter limits than reads - Leave
permanentunset ondocuments.delete. The default moves the document to the trash, where it can be restored for 30 days
Questions
Which is better for AI agents, Notion MCP or Outline?
Outline scores 60.3 (C) on agent readiness against Notion MCP's 58.9 (C), and leads in 4 of 7 scored categories. Notion MCP leads on reliability.
Do Notion MCP and Outline need an API key?
Notion MCP uses an OAuth sign-in. Outline takes an API key or an OAuth sign-in.
Can an agent call Notion MCP and Outline without installing anything?
Yes. Notion MCP has a hosted endpoint at https://mcp.notion.com/mcp and Outline at https://app.getoutline.com/api.
Are Notion MCP and Outline open source?
Notion MCP is open source (MIT). No open-source release is listed for Outline.
Other comparisons with Notion MCP or Outline
Machine-readable
- This page as Markdown
/compare/notion-mcp-vs-outline.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/notion-mcp.json·/api/v1/tools/outline.json - From a terminal
anchor compare notion-mcp outline(the CLI) - Over MCP
compare_tools {"a": "notion-mcp", "b": "outline"}at/mcp, no key