Skip to main content
Back to the Notion MCP server

MCP Gateway · Claude

Notion icon

Connect Notion to Claude

People ask Claude where a policy lives or what was decided in a meeting, and the answer is usually in Notion. Through the organization's connector, Claude can search the workspace, read the page, summarize a comment thread and leave feedback on a draft. Each person sees only the Notion tools their role can reach.

Category
Productivity
Tools
14
Authentication
OAuth
Claude
Web, desktop and mobile

Behind the MCP Gateway

Run Notion MCP behind the MCP Gateway

One URL for every agent, sign-in through your IdP, RBAC down to the tool, and every Notion call inspected and logged.

Deploy on MCP Gateway

Set up

Add Notion to Claude in 4 steps

  1. 01

    Add Notion from the catalog

    An admin finds Notion in the MCP Catalog (MCP Gateway > MCP > Catalog) and clicks Add. Speakeasy registers the vendor's server as a remote MCP server and proxies sessions to it. Nothing is copied or re-hosted.

    Notion uses OAuth. Servers that support dynamic client registration get their OAuth configuration applied automatically.

    Where MCP-scoped policies are enabled, the install offers a recommended risk policy for the new server that detects secrets and PII and inspects tool requests and responses.

  2. 02

    Choose who can use Notion

    Give teams the mcp:connect scope on the Notion server through team access or a role. The organization gateway works out each person's servers from their live access, so granting access adds Notion to their gateway on the next call, and removing it takes it away.

  3. 03

    Connect Claude

    Add the gateway URL as a custom connector, then connect it from Customize > Connectors.

    On Team and Enterprise plans, an Owner opens Organization settings > Connectors, chooses Add > Custom > Web and pastes the gateway URL.

    Each person opens Customize > Connectors and clicks Connect to sign in.

    On Pro and Max plans, each person adds it themselves under Customize > Connectors, with + Add > Add custom connector.

  4. 04

    Sign in and use Notion from Claude

    The first time Claude connects, it opens a browser so the person can sign in to Speakeasy through your identity provider.

    Notion needs its own OAuth grant, so each person connects it once. Until they do, Notion calls fail while the rest of the gateway keeps working.

    From then on, Notion's tools appear in Claude, limited to what the person's access allows, and every call lands in the gateway's tool logs.

No client ID or secret is needed: the gateway's sign-in handles client registration. Each person only sees the servers their role can reach.

Use cases

What Claude users do with Notion

Answer questions from the wiki

Ask about the travel policy or the onboarding checklist. Claude searches Notion for the right page, reads it and answers with a link to the source.

notion-searchnotion-fetch

Catch up on a page's discussion

Back from leave? Claude reads the discussions on a plan or proposal page and summarizes what was raised and what is still open.

notion-get-comments

Leave feedback on a draft

Ask Claude to review a draft page and add comments on specific passages, so the author sees each suggestion where it applies.

notion-fetchnotion-create-comment

Tools

14 tools

Each Notion tool can be allowed or denied per team and role at the MCP Gateway before Claude sees it.

notion-fetch

Retrieves details about a Notion entity (page, database, or data source) by URL or ID. Provide URL or ID in id parameter. Make multiple calls to fetch multiple entities. Pages use enhanced Markdown format.

notion-create-pages

Overview Creates one or more Notion pages, with the specified properties and content. Parent All pages created with a single call to this tool will have the same parent. The parent can be a Notion page ("page_id") or data source ("data_source_id").

notion-update-page

Overview Update a Notion page's properties or content. Properties Notion page properties are a JSON map of property names to SQLite values. For pages in a database: - ALWAYS use the "fetch" tool first to get the data source schema and the exact property names.

notion-move-pages

Move one or more Notion pages or databases to a new parent.

notion-duplicate-page

Duplicate a Notion page. The page must be within the current workspace, and you must have permission to access it. The duplication completes asynchronously, so do not rely on the new page identified by the returned ID or URL to be populated immediately.

See all 14 tools

Control

What Speakeasy can see and stop in Claude

The gateway covers every client the same way. The rest depends on what Claude exposes to Speakeasy.

Tool logs

Gateway

Every Notion call is logged with the person and the client that made it.

Access by role

Gateway

People reach only the Notion tools their team or role allows.

Request and response blocking

Gateway

A risk policy scoped to Notion can reject a tool request before it reaches the server, or withhold a result from Claude. MCP-scoped policies are enabled per organization.

Anthropic inference hooks

Claude

On Claude Enterprise, each prompt is sent to Speakeasy before inference and denied prompts are blocked (beta). Inference hooks can't rewrite or redact a prompt.

Conversation import

Claude

Claude conversations can be imported through Anthropic's Compliance API for review after the fact.

  • Custom connectors need a Claude plan that supports them.
  • Budgets don't cover Claude web and desktop usage.

Questions

Frequently asked questions

Can Notion prompts in Claude be blocked?
On Claude Enterprise, Anthropic inference hooks send each prompt to Speakeasy before inference and block denied prompts (beta). They can't rewrite or redact a prompt.
Does anyone hold a Notion credential in Claude?
No. Every session signs in through your identity provider with OAuth 2.1, and agents never hold a Notion credential. Access ends when the employee leaves the directory.
How do Claude users get Notion?
An admin adds Notion from the Speakeasy MCP Catalog and grants access by team or role. Add the gateway URL as a custom connector, then connect it from Customize > Connectors. Each person then sees only the Notion tools their access allows.
Are Notion calls from Claude logged?
Yes. Notion calls go through the MCP Gateway, which logs each tool call and attributes it to the person and the client that made it.

Connect more

Notion in other clients

AI everywhere.

Control here.