Notion MCP server: use AI to search, write, and update your workspace

What the Notion MCP server does

Notion is where most teams store their knowledge: meeting notes, project docs, databases, wikis. The Notion MCP server makes all of that accessible to your AI assistant.

Once connected, you can ask:

• "Find my notes from last week's product review"
• "Create a new page in the Engineering docs with a summary of today's standup"
• "Update the task database: mark the authentication sprint as complete"
• "What databases do I have in my workspace?"
• "Add a comment to the roadmap page asking about the Q2 launch date"

Your AI becomes a natural language interface to Notion, not just a writing tool that generates text you then copy-paste.

New to MCP? Read What is an MCP server? first, or see How to install an MCP server for a general setup guide.

What it exposes

The Notion MCP server wraps the Notion API and exposes tools for:

Pages: create, read, update content, add blocks, search by title

Databases: query, filter, sort, create items, update properties

Blocks: append, delete, retrieve by ID

Search: full-text search across your workspace

Comments: create and retrieve discussion threads

Prerequisites

• A Notion account
• A Notion Internal Integration Token
• Node.js 18+ and an MCP-compatible client

Setup

Step 1: Create a Notion integration

Go to notion.so/my-integrations and create a new internal integration. Give it a name. Copy the integration token.

Step 2: Share pages with your integration

Notion integrations only see pages you explicitly share with them. Open the pages or databases you want to access, click the three-dot menu, go to Connections, and add your integration.

Step 3: Configure your MCP client

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

Best practices

Share selectively. Only share the databases and pages your AI actually needs. This limits what the AI can accidentally modify.

Use databases for structured data. Notion databases have typed properties, which means the AI can filter and query them precisely. Plain pages are harder to query programmatically.

Combine with other servers. The Notion MCP server pairs well with the GitHub and Slack servers. You can pull a GitHub issue, summarize it, and write the summary into Notion without touching either interface manually.

Local vs remote

The setup above runs the Notion server locally via npx. Notion also offers an official remote MCP server that connects via a URL, so Node.js is not required.

Find it on MCP Marketplace

Browse the Notion MCP server on MCP Marketplace to see the security score and user ratings, or explore other productivity servers that work well alongside it.

For a broader list of useful servers, see Best MCP servers for developers.