Connect Notion to claude.ai

story-notion-mcp-remote-claude-ai-connect User Story

active user-story

story: Connect Notion to claude.ai

Role

Operator (Lucas) using claude.ai as an MCP client.

Key

claude-ai-connect

Want

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 /health returns 200
  • [ ] /.well-known/oauth-authorization-server returns 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 search tool 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.
  • arch-dataflow-notion-mcp-remote — OAuth handshake and tool-call sequences
  • arch-deployment-notion-mcp-remote — Tailscale Funnel and ingress that expose the URL
  • project-notion-mcp-remote — project page
  • board-notion-mcp-remote — board that executes this story