Ranked roundup · Notion
Best MCP Server for Notion
The MCP server for Notion question has an unusually clean answer: Notion ships its own, twice. There is a hosted server at mcp.notion.com that connects over OAuth, and an open-source local server, makenotion/notion-mcp-server, with 4,618 GitHub stars, that runs on an integration token. The wrinkle is that Notion has said it is prioritizing the hosted version and may sunset the local repo, and that shapes this ranking more than anything the community has built. The community still matters at the edges - suekou/mcp-notion-server (922 stars) is a leaner, token-conscious alternative that tracks Notion's newest API version - and managed platforms like Composio wrap Notion in hosted auth if you would rather run nothing at all. We ranked these four on verifiable criteria only: official status, last push date, star counts, auth model, and documented tool coverage. No paid placement, no invented benchmarks. Where a server carries an unflattering caveat, sunset warnings included, it is listed.
Facts checked September 1, 2026 · ranked on verifiable criteria · placement is never for sale
Founder, Automation Squad ·
The ranking
- Official · Notion
Almost everyone. If you just want your agent working inside your Notion workspace with the least friction and the most coverage, start here.
The widest documented tool set of the four: search across Notion plus connected apps (Slack, Google Drive, Jira), fetch pages as Markdown, create and update pages and databases, query data sources with SQL-style filters, manage database views, comments, users, teamspaces, page moves and duplication, and file upload/download. Documented rate limits: 180 requests per minute per user, 30 per minute for search; 20 MiB cap on single-part file uploads.
Remote, hosted by Notion. Nothing to install or run. · OAuth. You add https://mcp.notion.com/mcp (Streamable HTTP) to your client, approve in the browser, and the connection acts with your user's permissions. No API keys to manage. Workspace owners can review and revoke connections in Settings, and Enterprise admins can do it via the Admin API.
- Some tools - notably search across connected apps - require a Business or Enterprise plan with Notion AI; the free-plan experience is narrower than the full tool list suggests.
- OAuth grants your full user-level access; there is no way to scope the connection to specific pages the way an internal integration token can be.
- Rate-limited at 180 requests/minute (30/minute for search), which agents doing bulk work will hit.
- Hosted only - no self-host option, so your traffic goes through Notion's server.
- Official · Notion
Teams that need self-hosting, or want token-scoped access limited to specific shared pages rather than a full user-level OAuth grant.
Wraps the public Notion API. Version 2.0.0 targets the 2025-09-03 API with data sources as the primary database abstraction: page and block CRUD, database and data-source queries, search, comments, users. No connected-app search, views management, or SQL-style querying - those are hosted-only.
Local/self-hosted via npm (@notionhq/notion-mcp-server) or Docker; runs over stdio. · Internal integration token (NOTION_TOKEN env var) created at notion.so/profile/integrations. Access is scoped: the server only sees pages and databases you explicitly share with the integration, and you can restrict the integration's capabilities (e.g. read-only) in Notion's settings. · MIT · 4,618★
- Notion's own README says it is prioritizing the hosted server and may sunset this repo; issues and pull requests are not actively monitored.
- Last pushed 2026-07-25 - alive, but the community alternative below has shipped more recently.
- The integration token sits in plaintext in your client config; treat it like a password.
- Every page or database the agent should see must be manually shared with the integration first - a common source of 'it can't find my page' confusion.
- Community
Heavy agent use where the official servers' verbose JSON responses eat your context window, or anyone who wants the current data-source API model self-hosted.
Designed around keeping agent context small: compact page reads with stable block IDs, simplified high-level tools for finding, reading, querying and editing (paragraphs, headings, todos, callouts, safe Markdown append), with raw JSON tools as a fallback. Targets Notion API 2026-03-11 - a newer API version than the official local server currently ships.
Local/self-hosted, runs over stdio. · Internal integration token (NOTION_API_TOKEN env var), same integration-sharing model as the official local server: the agent only sees what you share with it. · MIT · 922★
- Unofficial - Notion provides no support and no compatibility guarantees.
- Effectively a single-maintainer project; 922 stars is respectable but a fraction of the official repo's adoption.
- Same manual page-sharing and plaintext-token realities as the official local server.
- Community
No-code and multi-app agent builders who want Notion, plus dozens of other integrations, behind one endpoint with auth handled for them.
Notion page and database creation and management, bulk block/content writes, comments, and workspace organization, exposed as Composio's own tool abstractions over the Notion API - one toolkit among 500+ apps on the same platform.
Fully managed and hosted by Composio; no local process. · Managed OAuth. Composio handles the OAuth flow, token storage, refresh, and scopes; you connect once and point any supported client or agent framework at their hosted endpoint. Composio states SOC 2 Type 2 compliance and encryption of stored credentials.
- A third party sits between your agent and your Notion workspace - your Notion tokens and traffic live on Composio's infrastructure.
- Commercial service requiring a Composio account, with its own pricing beyond the free tier.
- Tool names and behavior are Composio's abstraction, not Notion's official MCP tools, so docs and examples for the official servers won't map one-to-one.
- We could not verify adoption numbers the way GitHub stars allow for the open-source options.
Notion MCP servers compared
| Server | Maintained by | Runs | Auth | License |
|---|---|---|---|---|
| Notion MCP (hosted, official) | Notion | Remote, hosted by Notion. Nothing to install or run. | OAuth. You add https://mcp.notion.com/mcp (Streamable HTTP) to your client, approve in the browser, and the connection acts with your user's permissions. No API keys to manage. Workspace owners can review and revoke connections in Settings, and Enterprise admins can do it via the Admin API. | — |
| makenotion/notion-mcp-server (official, self-hosted) | Notion | Local/self-hosted via npm (@notionhq/notion-mcp-server) or Docker; runs over stdio. | Internal integration token (NOTION_TOKEN env var) created at notion.so/profile/integrations. Access is scoped: the server only sees pages and databases you explicitly share with the integration, and you can restrict the integration's capabilities (e.g. read-only) in Notion's settings. | MIT |
| suekou/mcp-notion-server (community) | Community | Local/self-hosted, runs over stdio. | Internal integration token (NOTION_API_TOKEN env var), same integration-sharing model as the official local server: the agent only sees what you share with it. | MIT |
| Composio Notion MCP (managed) | Community | Fully managed and hosted by Composio; no local process. | Managed OAuth. Composio handles the OAuth flow, token storage, refresh, and scopes; you connect once and point any supported client or agent framework at their hosted endpoint. Composio states SOC 2 Type 2 compliance and encryption of stored credentials. | — |
How to choose
Pick the hosted Notion MCP if you want the full tool set - search across connected apps, database views, file uploads - with OAuth handled for you; note that some tools require a Business or Enterprise plan with Notion AI. Pick the local official server if you need self-hosting or deliberately scoped integration-token access, and can accept that Notion may sunset it. Pick suekou/mcp-notion-server if context bloat is your problem - it is built for compact, agent-friendly responses. Pick Composio if Notion is one of many apps your agent touches and you want auth managed centrally.
How this ranking works
Every server here is real and was checked against its repository or vendor documentation on the date above — stars and licenses come from the GitHub API, not from memory. Order reflects verifiable criteria only: official support, maintenance recency, adoption, auth model, and documented capability coverage. We do not run paid placements, and we list every caveat we find, including the unflattering ones.
Common questions
- Is there an official MCP server for Notion?
- Yes - two. Notion runs a hosted MCP server at mcp.notion.com (OAuth, Streamable HTTP) and maintains an open-source local server at makenotion/notion-mcp-server (4,618 stars, MIT). Notion has said it is prioritizing the hosted one and may sunset the local repo.
- How does setup and auth actually work?
- For the hosted server, you add https://mcp.notion.com/mcp to your MCP client and approve an OAuth prompt in the browser - the connection then acts with your user's full permissions. For the local and community servers, you create an internal integration at notion.so/profile/integrations, put its token in your client config, and manually share each page or database with the integration - anything not shared is invisible to the agent.
- Is the Notion MCP server free?
- The software is - the hosted server costs nothing to connect and both open-source servers are MIT-licensed. But some hosted tools, including search across connected apps like Slack and Google Drive, require a Business or Enterprise plan with Notion AI, and the hosted server enforces rate limits of 180 requests per minute (30 for search).
- Should I use the local official server or the hosted one?
- Hosted, unless you have a specific reason. Notion's own README warns the local repo may be sunset and says issues and PRs are not actively monitored. The remaining case for local is deliberate scoping: an integration token only reaches pages you explicitly share, while the hosted OAuth grant covers everything your account can touch.
MCP servers we build
Automation Squad publishes its own open-source MCP servers and agent skills, documented with the same rules this ranking uses.