How to Give Claude Access to Your Notion Workspace

What You Get

After following this tutorial, Claude will be able to:

• Read any page in your Notion workspace
• Query databases (filter, sort, paginate)
• Search across all pages and databases
• Pull structured data from tables and boards

All without writing a single line of code or managing API tokens manually.

Prerequisites

• A Notion account with at least one workspace
• Claude Desktop, Claude Code, Cursor, or any MCP client
• A DataFaucet account (free tier works)

Step 1: Start a Scan

Go to DataFaucet and paste your Notion workspace URL:

https://www.notion.so/your-workspace

Click "Launch Browser." A cloud browser opens with Notion loaded.

Step 2: Browse Your Workspace (60 Seconds)

This is where DataFaucet captures the API calls Notion's frontend makes. Browse normally:

1. Open 2-3 pages you want Claude to access
2. Open a database view (table, board, or list)
3. Use the search bar once (type a word, let results load)
4. Switch between a few database filters if you use them

Every page load and interaction triggers API calls under the hood. DataFaucet records them all.

Step 3: Stop and Review Endpoints

Click "Done - Capture Endpoints." You'll see a list of captured API calls:

• POST /api/v3/getPublicPageData — reads page content
• POST /api/v3/queryCollection — queries databases
• POST /api/v3/search — workspace search
• POST /api/v3/getRecordValues — fetches specific records

Toggle off any endpoints you don't want Claude to access.

Step 4: Deploy

Click "Deploy as Hosted MCP Server." You get:

• A server URL: https://datafaucet.dev/api/mcp/your-id/sse
• An API key for authentication

Step 5: Connect to Claude

Claude Desktop

Add to your MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "notion": {
      "url": "https://datafaucet.dev/api/mcp/YOUR_ID/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. You'll see "notion" in your available tools.

Claude Code

Add to .mcp.json in your project:

{
  "mcpServers": {
    "notion": {
      "type": "sse",
      "url": "https://datafaucet.dev/api/mcp/YOUR_ID/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor / Windsurf

Add the same config to your MCP settings. Both support SSE transport natively.

Step 6: Test It

Ask Claude:

• "Search my Notion workspace for meeting notes from last week"
• "Show me all items in my Projects database with status 'In Progress'"
• "Read the contents of my Q2 Planning page"

Claude calls the MCP tools, hits the Notion API with your captured auth, and returns structured results.

How It Works Under the Hood

Notion's web app uses internal API endpoints (/api/v3/*) for everything. When you browse, DataFaucet captures these calls including:

• The endpoint URL and method
• Request headers (including your session token)
• Request body structure (for POST calls)
• Response schema (to generate tool descriptions)

The generated MCP server replays these same API calls when Claude invokes a tool. Since it uses the actual API endpoints, responses are fast (50-200ms) and structured.

Session Expiry

Notion sessions expire after a few weeks. When they do, your MCP server will return auth errors. To fix it:

1. Go to your DataFaucet dashboard
2. Click "Re-scan" on the Notion server
3. Browse Notion for 10 seconds (just enough to refresh the session)
4. Done. Takes under 30 seconds.

Why Not Use Notion's Official API?

You can, but the official API requires:

• Creating an integration in Notion settings
• Sharing each page/database with the integration manually
• Writing code to map API responses to MCP tool schemas
• Hosting the MCP server yourself

DataFaucet skips all of that. You browse once, and the internal API gives you access to everything your account can see, including pages not explicitly shared with integrations.

Next Steps

• Watch the demo to see this flow in action
• Read about MCP if you're new to the protocol
• Try it with other apps like Slack, Linear, or your internal tools