If your workflow lives in Notion — meeting notes, project specs, content calendars, research databases — you’ve probably wasted more time than you’d like copying content into Claude just to get AI assistance on it. The Notion MCP server changes that. Once connected, Claude can search your workspace, read your pages, update content, and query databases directly, without you ever leaving the chat.
This guide covers everything you need to set up Notion MCP with Claude Desktop in 2026, including both available methods and the one critical step most people miss that causes setup to fail.
What Is Notion MCP?
MCP stands for Model Context Protocol — an open standard that lets AI tools like Claude connect directly to external services. Instead of copying and pasting content between apps, Claude reads from and writes to those services in real time.
Notion released an official MCP server in 2025, and it’s now the recommended way to give Claude access to your workspace. There are currently two ways to connect it, which we’ll cover in order of accessibility.
What You’ll Need
Before you start:
- Claude Desktop installed on Mac or Windows (free at claude.ai/download)
- A Notion account (free plan works)
- Node.js installed on your computer — required for Method 1 (download at nodejs.org)
- A Claude Pro, Max, Team, or Enterprise subscription — required only for Method 2
If you’re on the Claude free plan, use Method 1.
Method 1: API Token Setup (Works on Any Plan)
This method uses Notion’s official npm package and your Notion API token. It takes about 10 minutes and works with any Claude Desktop installation.
Step 1 — Create a Notion Integration
Go to notion.so/profile/integrations and click New integration. Give it a name (something like “Claude MCP”), select your workspace, and leave the type as Internal. Click Save.
On the next screen, copy the Internal Integration Token — it starts with ntn_. Keep this somewhere safe. This is your API key.
Step 2 — Edit claude_desktop_config.json
Open the config file for Claude Desktop. The location depends on your OS:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
If the file doesn’t exist yet, create it. Add the following:
json
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_YOUR_TOKEN_HERE"
}
}
}
}Replace ntn_YOUR_TOKEN_HERE with the token you copied in Step 1. If you already have other MCP servers configured in this file, add the notionApi block inside the existing mcpServers object — don’t create a second one.
Important: JSON is strict about syntax. A single missing comma or extra bracket breaks the entire file and Claude Desktop won’t load any MCP servers. Before saving, paste your config into a JSON validator (jsonlint.com works fine) to catch any errors.
Step 3 — Share Pages with Your Integration
This is the step most people skip, and it’s why setup appears to work but returns “object not found” errors when you actually try to use it.
By default, Notion integrations can’t access any pages. You have to explicitly share each page or database you want Claude to access:
- Open the Notion page you want Claude to read
- Click the … menu in the top right
- Select Connections (or Add connections)
- Find your integration name and click to connect
Do this for every page and database you plan to use. If you share a parent page, child pages inherit access automatically.
Step 4 — Restart Claude Desktop and Test
Fully quit Claude Desktop (not just close the window) and reopen it. Start a new conversation and ask:
“Search my Notion workspace for [page name]”
or
“What pages do you have access to in my Notion?”
If the connection is working, Claude will list or retrieve your content. If it’s not showing up, check the Troubleshooting section below.
Method 2: Hosted OAuth (Claude Pro, Max, Team, or Enterprise)
If you’re on a paid Claude plan, Notion also offers a hosted remote MCP server that authenticates via OAuth — no config file editing or API token required.
Step 1 — Open Claude Desktop Settings
In Claude Desktop, go to Settings → Connectors. This section is only visible on Pro, Max, Team, and Enterprise plans.
Step 2 — Add a Custom Connector
Click Add custom connector and enter the following URL:
https://mcp.notion.com/mcpStep 3 — Complete the OAuth Flow
Claude will prompt you to authorize the connection through Notion’s standard OAuth screen. Log in to Notion and approve the permissions. Once authorized, the connection is active.
No page-by-page sharing is required with this method — OAuth grants access based on what your Notion account can already see.
What You Can Do Once Connected
With Notion MCP active, you can ask Claude things like:
- “Find my Q3 content calendar in Notion and summarize what’s scheduled for next week”
- “Read the product spec page titled ‘Feature Roadmap’ and write a summary email”
- “Create a new page in my Projects database for the client onboarding workflow”
- “Search my Notion workspace for all mentions of [topic] and compile a brief”
- “Update the status field on the ‘Blog Post Drafts’ database to ‘Published’ for the article titled [name]”
The practical time-saver is eliminating context-switching: instead of opening Notion, copying a spec into Claude, and then working on it, you reference it directly in the conversation. For anyone using Notion as a knowledge base or project management hub, this adds up quickly.
Troubleshooting Common Errors
“object not found” or blank results: You haven’t shared the specific page with your integration. Go to the page in Notion, click the three-dot menu, and add your integration under Connections.
MCP server not appearing in Claude: JSON syntax error in your config file. Run the file through jsonlint.com, fix any errors, and restart Claude Desktop completely.
npx command fails on first run: Node.js is either not installed or not in your system PATH. Download Node.js from nodejs.org, install it, then restart your terminal and try again.
“Token is invalid” error: The token in your config doesn’t match the one in your Notion integration settings. Go back to notion.so/profile/integrations, open your integration, and copy the token again.
Method 2 (OAuth) not showing up in Settings: This feature requires a Claude Pro, Max, Team, or Enterprise subscription. Free plans only have access to Method 1.
A Note on the Deprecated Package
You may find older tutorials referencing a community package called notion-mcp-server (without the @notionhq/ prefix). That package is no longer actively maintained. Use @notionhq/notion-mcp-server — Notion’s official package — for all new setups.
Final Thoughts
Notion MCP is one of the more immediately useful MCP connections you can set up, especially if Notion is already central to how you organize work. The API token method works without a paid Claude plan and takes less than 15 minutes to configure. The main friction point is the page-sharing step — once you know about it, it’s a 30-second fix, but it’s not obvious and it’s what trips up most people on first setup.
If you’re new to MCP integrations with Claude, also check out our guides on connecting Higgsfield MCP and Metricool MCP — the same basic config file approach applies across all of them.
You Might Also Like
