MCP Gateway · Claude
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.
Set up
Add Notion to Claude in 4 steps
- 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.
- 02
Choose who can use Notion
Give teams the
mcp:connectscope 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. - 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.
- 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.
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.
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.
Tools
14 tools
Each Notion tool can be allowed or denied per team and role at the MCP Gateway before Claude sees it.
notion-search
Perform a search over: - "internal": Semantic search over Notion workspace and connected sources (Slack, Google Drive, Github, Jira, Microsoft Teams, Sharepoint, OneDrive, Linear). Supports filtering by creation date and creator. - "user": Search for users by name or email.
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.
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?
Does anyone hold a Notion credential in Claude?
How do Claude users get Notion?
Are Notion calls from Claude logged?
Connect more