# 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.

- Endpoint: https://mcp.notion.com/mcp
- Transport: Streamable HTTP
- Registry: com.notion/mcp 1.0.0
- Publisher documentation reviewed: 2026-11-05 (not a tested connection)
- Guide page: https://apitracker.io/mcp-guides/notion-mcp

## 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.
- 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.

## Steps

1. **Open Notion's MCP setup instructions for your client** <https://developers.notion.com/guides/mcp/get-started-with-mcp>
2. **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.
3. **Sign in to Notion and choose the workspace to authorize**
4. **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.
5. **List the server's tools**

## 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

- https://developers.notion.com/guides/mcp/get-started-with-mcp (checked 2026-11-05)
- https://developers.notion.com/docs/mcp (checked 2026-11-05)
- https://www.notion.com/help/notion-mcp (checked 2026-11-05)
- https://registry.modelcontextprotocol.io/v0.1/servers/com.notion%2Fmcp/versions/1.0.0 (checked 2026-11-05)
- https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization (checked 2026-11-05)

Guide JSON: https://github.com/apideck-libraries/mcp-connect/blob/626f6a146170ded34891b30dca3af26f09e07466/proposals/connection-guide/0.1/reviewed/guides/notion-mcp.json