Connect Notion to claude.ai
story: Connect Notion to claude.ai
Role
Operator (Lucas) using claude.ai as an MCP client.
Key
claude-ai-connectWant
As a claude.ai user, I want to paste a public URL into claude.ai's MCP integration settings and complete Notion OAuth.
So That
So that I can use Notion tools inside claude.ai chats without running a local stdio server or juggling integration tokens.
Acceptance Criteria
- [ ] Public HTTPS URL resolves and
/healthreturns 200 - [ ]
/.well-known/oauth-authorization-serverreturns valid MCP OAuth metadata - [ ] claude.ai accepts the URL as an MCP server
- [ ] Notion OAuth handshake completes (consent screen → code → token) without error
- [ ] After OAuth, a
searchtool call in a claude.ai chat returns live results from the authorized workspace - [ ] Access token lifetime is 1 year so reconnection is rare
Success Metric
Lucas pastes the URL into claude.ai, completes OAuth in under 60 seconds, and runs a Notion tool successfully on the first attempt.
Related Architecture
arch-dataflow-notion-mcp-remote— OAuth handshake and tool-call sequencesarch-deployment-notion-mcp-remote— Tailscale Funnel and ingress that expose the URL
Related
project-notion-mcp-remote— project pageboard-notion-mcp-remote— board that executes this story