How to connect the Notion MCP server

To connect the official Notion MCP server, add https://mcp.notion.com/mcp to your MCP client as a Streamable HTTP server, then sign in with OAuth when your client prompts you. For non-interactive use, use an MCP token. Notion documents setup for Codex, Claude Code, Cursor, VS Code, Claude and ChatGPT.

Docs reviewed 5 Nov 2026Not a tested connection.

Try in the browser with your key →

Endpoint https://mcp.notion.com/mcp · Registry com.notion/mcp 1.0.0

Open in the Notion MCP explorer →Notion API profile →Markdown for agents

Add Notion MCP to your client

My client can't use OAuth: send a key from NOTION_API_KEY

Terminal

codex mcp add notion --url https://mcp.notion.com/mcp

developers.notion.com/guides

Connect Notion MCP step by step

Before you start

A Notion account that is a member of the workspace. Guests can't connect. Notion MCP works on every plan, though some features and request limits depend on plan. developers.notion.com/guides
On Enterprise, admins can allow only approved AI apps. If the connection is blocked by workspace policy, ask a workspace owner or admin to approve the client. notion.com/help developers.notion.com/guides
MCP tools act with your full Notion permissions and can access everything you can access. notion.com/help

Authentication

Your client → Notion MCP: OAuth sign-in, handled by your MCP client. developers.notion.com/guides modelcontextprotocol.io/specification
Notion MCP → Notion API: The server acts on your account with the access you approve. notion.com/help

Steps

Open Notion's MCP setup instructions for your client
developers.notion.com/guides/mcp/get-started-with-mcp
Add the Notion MCP server to your client
Add https://mcp.notion.com/mcp as a remote MCP server that uses the Streamable HTTP transport. Use the SSE endpoint https://mcp.notion.com/sse only if your client doesn't support Streamable HTTP. Many assistants also list Notion in their connector or plugin directory. Clients that support only local servers can use the mcp-remote bridge.
developers.notion.com/guides registry.modelcontextprotocol.io/v0.1
Sign in to Notion and choose the workspace to authorize
developers.notion.com/guides
For non-interactive use, use an MCP token
On Business and Enterprise plans, a workspace owner can create an MCP token in the Notion developer portal. Send it as a bearer token in the Authorization header to the same endpoint; no browser sign-in is needed. Keep the token in an environment variable or secret store. Enterprise workspaces with SAML SSO can instead use enterprise-managed authorization through the identity provider.
developers.notion.com/guides
List the server's tools
Your client should list the server's tools. That confirms the connection, not every API permission.
developers.notion.com/guides

What we observed

5 Nov 2026: HTTP 401 with WWW-Authenticate resource_metadata https://mcp.notion.com/.well-known/oauth-protected-resource/mcp and scope default. The metadata names the authorization server https://mcp.notion.com.

Notion MCP questions

What is the Notion MCP server URL?

The official Notion MCP server is at https://mcp.notion.com/mcp and uses the Streamable HTTP transport.

How do I authenticate with the Notion MCP server?

Sign in with OAuth when your client prompts you. For non-interactive use, use an MCP token: On Business and Enterprise plans, a workspace owner can create an MCP token in the Notion developer portal. Send it as a bearer token in the Authorization header to the same endpoint; no browser sign-in is needed. Keep the token in an environment variable or secret store. Enterprise workspaces with SAML SSO can instead use enterprise-managed authorization through the identity provider.

Which AI clients can use the Notion MCP server?

Notion's documentation covers Codex, Claude Code, Cursor, VS Code, Claude and ChatGPT. Other clients that support remote Streamable HTTP MCP servers may also work.

What do I need before connecting Notion MCP?

A Notion account that is a member of the workspace. Guests can't connect. Notion MCP works on every plan, though some features and request limits depend on plan. On Enterprise, admins can allow only approved AI apps. If the connection is blocked by workspace policy, ask a workspace owner or admin to approve the client. MCP tools act with your full Notion permissions and can access everything you can access.

Has this Notion MCP guide been tested?

Notion's documentation was reviewed on 2026-11-05. It is not a tested connection; your account and permissions decide which tools work.

Sources and review

Notion's documentation was checked on the dates shown. This guide follows the MCP Connect connection-guide draft, bound to the exact Registry record it describes. It is not a tested connection: your account and permissions decide which tools work.

Guide source and binding

MCP connection guide (draft 0.1) for com.notion/mcp 1.0.0, bound to /remotes/0 of the Registry record by SHA-256 3e753803c2ee….

Guide JSON Source snapshot

developers.notion.com/guides/mcp/get-started-with-mcp · checked 5 Nov 2026
developers.notion.com/docs/mcp · checked 5 Nov 2026
www.notion.com/help/notion-mcp · checked 5 Nov 2026
registry.modelcontextprotocol.io/v0.1/servers/com.notion%2Fmcp/versions/1.0.0 · checked 5 Nov 2026
modelcontextprotocol.io/specification/2026-07-28/basic/authorization · checked 5 Nov 2026

All MCP connection guides →How we review MCPs →