MCP Integration

Notion MCP Server

Connect Claude to your Notion workspace. Read pages, search databases, create content, and manage your knowledge base without leaving your AI assistant.

What is the Notion MCP server?

The Notion MCP server bridges your Notion workspace and AI assistants that support the Model Context Protocol. Once connected, Claude can interact with your Notion data the same way you would through the app: reading pages, querying databases, creating new content, and updating existing records.

Notion provides an official MCP integration that works with Claude Desktop and Claude Code out of the box. It uses OAuth to authenticate, so you sign in with your Notion account and choose which pages and databases to share. No API keys to manage manually.

What it can do

Read and search pages

Search across your workspace by title or content. Fetch the full contents of any page, including nested blocks, databases, and properties.

Create and update pages

Create new pages in any database or as standalone pages. Update page properties, titles, and content blocks. Add rows to database tables.

Query databases

Filter and sort database entries by any property. Pull structured data from your Notion databases for analysis, reporting, or populating other systems.

Manage comments

Read and add comments on any page. Useful for automated review workflows or adding AI-generated notes to existing documents.

Organize content

Move pages between databases, duplicate pages, and create database views. Manage your workspace structure programmatically.

Setup guide

Option A: Claude Desktop (recommended)

Claude Desktop has built-in support for the Notion MCP server. No installation required.

  1. 01 Open Claude Desktop and go to Settings > Integrations.
  2. 02 Find Notion in the list and click Connect.
  3. 03 Sign in with your Notion account when prompted.
  4. 04 Select which pages and databases you want Claude to access. You can change this later from Notion's integration settings.
  5. 05 Start a new conversation. Claude now has access to your Notion workspace. Try asking it to search for a page or summarize a database.

Option B: Claude Code / manual configuration

For Claude Code or other MCP-compatible clients, you can add the Notion server to your MCP config file.

Add this to your claude_desktop_config.json or MCP settings file:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "your-notion-integration-token"
      }
    }
  }
}

To get your Notion API key:

  1. 01 Go to notion.so/my-integrations and create a new integration.
  2. 02 Give it a name (e.g., "Claude MCP") and select your workspace.
  3. 03 Copy the Internal Integration Secret and paste it as your NOTION_API_KEY.
  4. 04 In Notion, share the pages/databases you want Claude to access with your integration. Open the page, click "..." in the top right, then "Connections", and add your integration.

Use cases

Meeting notes to action items

After a meeting, tell Claude to create a new page in your meetings database with a summary, decisions made, and action items assigned to team members.

Project status updates

Ask Claude to read your project tracker database, identify what changed this week, and write a status update page with highlights and blockers.

Knowledge base sync

Have Claude search your docs for outdated information, flag pages that reference deprecated tools, or draft updated documentation based on recent changes.

Database entry from conversations

During a planning session, tell Claude to add new rows to your content calendar, bug tracker, or CRM database without switching apps.

Research and summarization

Point Claude at a Notion database full of research notes and ask for a synthesized summary, key themes, or gaps in coverage.

Template population

Duplicate a template page and fill it in with specific information. Useful for client onboarding docs, project briefs, or recurring reports.

Limitations

  • Page size limits. Very large pages with hundreds of blocks may be truncated. The Notion API returns blocks in paginated batches, and extremely deep nesting can hit rate limits.
  • No file uploads. The MCP server can create and update text content, but it cannot upload files, images, or attachments to Notion pages.
  • Permission scope. Claude can only access pages and databases that have been explicitly shared with the integration. It cannot see private pages unless you grant access.
  • Rate limiting. Notion's API has rate limits (roughly 3 requests per second for integrations). Bulk operations on hundreds of pages may need to be batched.
  • No real-time sync. The MCP server reads data on demand. It does not maintain a live connection or push updates when Notion content changes.

FAQ

What is the Notion MCP server?

It's an integration that connects AI assistants like Claude to your Notion workspace using the Model Context Protocol. It lets Claude read pages, search databases, create content, and manage blocks directly inside Notion.

Is the Notion MCP server free?

The Notion MCP integration is available as a built-in integration in Claude Desktop and Claude Code at no additional cost. You need an active Notion account and the appropriate permissions to connect your workspace.

Can Claude edit my Notion pages?

Yes. With the Notion MCP server connected, Claude can create new pages, update existing ones, add comments, search databases, and manage page properties. You control which pages and databases the integration can access through Notion's sharing settings.

Can I use this with a team workspace?

Yes. You authenticate with your own Notion account, and Claude inherits your access level. If you can see a page in Notion, Claude can access it through the MCP server (as long as the integration is connected to that page).

What happens to my data?

When using the local MCP server, your Notion API key stays on your machine. Requests go directly from your computer to Notion's API. Claude sees the content you share in the conversation but does not store your Notion data separately.

Need Help?

Need help setting up Notion MCP?

We build custom Notion integrations and MCP workflows for teams. If you need something beyond the standard setup, we can help.

Book a Call