What is the Notion MCP server for Claude?

Quick Answer: The Notion MCP server connects Claude directly to your Notion workspace using the Model Context Protocol. Once set up, Claude can read, search, update, and create Notion pages through natural language. Setup takes under 20 minutes and requires no coding experience.

The Notion MCP integration turns Claude from a standalone AI assistant into something genuinely useful for B2B SaaS teams: an AI that can read your actual documentation, query your databases, and update your pages without you switching tabs.

This guide covers the full setup for both Claude Desktop and Claude Code, plus the practical workflows SaaS teams get the most value from once everything is connected.

What Is the Notion MCP Server?

The Notion MCP server is an official integration built by Notion that uses the Model Context Protocol (an open standard created by Anthropic) to give Claude direct access to your Notion workspace. Instead of copying and pasting content into Claude, Claude reads and writes to Notion directly.

This matters for B2B SaaS teams because your Notion workspace likely holds your product specs, customer research, onboarding docs, and meeting notes. Connecting Claude to that context makes it a much more useful assistant than one working from scratch.

What Claude can do once connected:

• Search across your entire Notion workspace by keyword or topic
• Read the full content of any page it has access to
• Query database entries and filter by properties
• Create new pages and database entries
• Update existing page content
• Summarise long documents on request

What You Need Before You Start

Before setting up the Claude Notion MCP integration, confirm you have the following:

• Claude Desktop (free or Pro) or Claude Code installed
• A Notion account (any plan)
• Node.js installed on your machine (version 18 or higher)
• Admin access to your Notion workspace, or permission to create integrations

If you are using Claude Code specifically, Notion also publishes an official plugin that bundles the MCP server with pre-built slash commands. That option is covered separately below.

How to Set Up Notion MCP with Claude Desktop

Step 1: Create a Notion Integration

1. Go to notion.so/my-integrations
2. Click New integration
3. Give it a name (e.g. "Claude MCP")
4. Select the workspace you want Claude to access
5. Under capabilities, enable Read content, Update content, and Insert content
6. Click Save
7. Copy the Internal Integration Token that appears. You will need this in Step 3.

Step 2: Connect Pages to Your Integration

Notion integrations only access pages you explicitly share with them. This is a security feature, not a bug.

For each Notion page or database you want Claude to access:

1. Open the page in Notion
2. Click the three-dot menu (top right)
3. Select Connections
4. Find your integration name and click Confirm

You can share a top-level page to give Claude access to everything nested beneath it.

Step 3: Configure the MCP Server in Claude Desktop

Open your Claude Desktop configuration file. On Mac, this lives at:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add the following to the file, replacing YOUR_INTEGRATION_TOKEN with the token from Step 1:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_INTEGRATION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Step 4: Restart Claude Desktop

Fully quit Claude Desktop and reopen it. When the app loads, you should see a hammer icon in the bottom-left of the chat interface. That confirms the MCP server is active and Claude has tool access.

Step 5: Test the Connection

Type this into Claude:

"Search my Notion workspace for pages about [a topic you know exists]."

If Claude returns results from your workspace, the integration is working.

How to Set Up Notion MCP with Claude Code

Claude Code users have a slightly different (and faster) option: the official Notion plugin for Claude Code.

Option A: Install the Official Notion Plugin

The official plugin (published at makenotion/claude-code-notion-plugin on GitHub) bundles the MCP server with pre-built skills and slash commands. It is the recommended path if you use Claude Code as your primary interface.

Installation steps:

1. Open Claude Code
2. Run the following command in the terminal:

claude mcp add notionhq/notion-mcp-server

3. When prompted, paste your Notion integration token
4. Confirm the connection

The plugin adds slash commands like /notion-search, /notion-create, and /notion-update directly into your Claude Code workflow.

Option B: Manual Configuration via claude.json

If you prefer manual setup or need custom configuration, add the Notion MCP server to your claude.json file using the same JSON structure shown in the Claude Desktop section above.

Practical Workflows for B2B SaaS Teams

Getting the integration running is step one. Here is where it actually pays off.

Querying Your Notion Databases

SaaS teams often store customer data, feature requests, or sprint tasks in Notion databases. Once Claude has access, you can query those databases in plain English.

Example prompts:

• "Find all database entries in my product roadmap where status is 'In Review'"
• "Show me every page tagged with the customer name Acme Corp"
• "List all tasks assigned to [name] that are marked as high priority"

Claude reads the database properties and filters results without you building any custom views.

Summarising Long Documents

Product specs, customer research reports, and onboarding guides tend to grow long. Claude can summarise any connected Notion page in seconds.

Example prompts:

• "Summarise the Q2 customer research page in 5 bullet points"
• "Give me the key decisions from the architecture decision record for our billing system"
• "What are the main objections captured in our sales playbook?"

This is particularly useful before customer calls or internal reviews when you need a fast brief. Teams building more structured documentation and repeatable content workflows often pair this kind of setup with strong B2B SaaS content marketing agencies support to turn internal knowledge into pipeline-driving assets.

Updating Pages Without Leaving Your Workflow

Claude can write content back to Notion, not just read from it. For SaaS teams, this removes the friction of context-switching between your AI assistant and your documentation tool.

Example prompts:

• "Add a new section to our onboarding checklist for enterprise customers covering SSO setup"
• "Update the status property on the 'API rate limiting' feature page to 'Shipped'"
• "Create a new page in our meeting notes database with today's date and the following summary: [paste notes]"

Building a Living Knowledge Base

The most durable use case for claude notion mcp in a B2B SaaS context is treating Notion as a persistent memory layer for Claude. Instead of re-explaining your product, your customers, or your processes in every conversation, Claude reads that context from Notion at the start of each session.

Set this up by:

1. Creating a "Claude Context" page in Notion with your ICP, product positioning, and key terminology
2. Sharing that page with your integration
3. Starting each Claude session with: "Read my Claude Context page in Notion before we begin"

This takes roughly 30 minutes to build and saves significant time on every subsequent session. For larger teams, this kind of process becomes part of broader B2B SaaS marketing operations, especially when documentation, campaign execution, and reporting all need to stay aligned.

Troubleshooting Common Setup Issues

Claude says it cannot find any Notion tools The MCP server did not load. Fully quit and restart Claude Desktop. Check your claude_desktop_config.json for JSON syntax errors (a missing comma or bracket will break the whole file).

Claude can search but returns no results Your integration has not been connected to any pages. Go back to Step 2 and share the relevant pages with your integration.

Authentication errors when Claude tries to access Notion Your integration token has likely been entered incorrectly. Return to notion.so/my-integrations, regenerate the token, and update your config file.

Claude can read pages but cannot update them Check your integration capabilities. Go to notion.so/my-integrations, open your integration, and confirm that "Update content" and "Insert content" are both enabled.

Claude Desktop vs Claude Code: Which Should You Use?

Both options use the same underlying Notion MCP server and offer identical access to your workspace. The difference is interface preference, not capability.

FAQs

What is the Notion MCP server and how does it work with Claude? The Notion MCP server is an official integration that uses the Model Context Protocol to give Claude direct read and write access to your Notion workspace. Claude sends requests to the MCP server, which translates them into Notion API calls. The result is that Claude can search, read, create, and update Notion content through natural language without any manual copy-pasting.

Is the Claude Notion MCP integration free to use? The Notion MCP server itself is free and open source. You need a Claude plan that supports MCP tool use (Claude Pro or higher for Claude Desktop, or Claude Code which has its own pricing). Notion's free plan supports integrations, so no paid Notion plan is required.

How do I add Notion MCP to Claude Code specifically? Run claude mcp add notionhq/notion-mcp-server in your Claude Code terminal and follow the prompts to enter your Notion integration token. Alternatively, install the official Notion plugin for Claude Code from the makenotion/claude-code-notion-plugin GitHub repository, which adds the MCP server plus pre-built slash commands in a single step.

Can Claude edit my Notion pages, or only read them? Claude can read, create, and update Notion pages and database entries, provided your integration has the correct capabilities enabled. Go to notion.so/my-integrations and confirm that "Update content" and "Insert content" are both active on your integration.

Is it safe to connect Claude to my Notion workspace? Notion integrations only access pages you explicitly share with them. Claude cannot see any pages outside those you have connected. Your integration token should be kept private and stored only in your local config file, never in a shared or public repository.