Notion MCP

Official Notion MCP server — read and write Notion pages, databases, and blocks through AI-powered natural language interactions.

TRUSTED · Official

Productivity APIs

// Add to your client

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

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

Paste into your client's MCP configuration file.

// Try it now

"Find my most recent Notion pages and summarize what I've been working on this week"

! Requires a Notion integration token, and each page/database must be shared with the integration explicitly
! Block-level editing is limited — complex layouts may not round-trip perfectly
! Database property types matter — writing to a rollup or formula column will fail

Setup

Easy Setup

API key or simple config

Token usage

Light usage

// When to use

You use Notion as your primary knowledge base and want AI to read from it
You need to create or update pages from conversation without leaving your editor
You want to query Notion databases by filter, sort, or formula
You're building a second-brain workflow where AI maintains notes for you

// When NOT to use

You use Obsidian, Roam, or a local notes system (use obsidian-mcp instead)
You need to manipulate complex embedded blocks like synced databases with full fidelity
You need offline access — this requires the Notion API to be reachable

// Usage Scenarios

Knowledge Base Q&A

Ask your AI questions that it answers by searching your Notion workspace.

Example prompt

"Find the engineering onboarding doc in Notion and tell me what tools a new hire needs to install"

Database Updates

Add, edit, and query database entries like tasks, CRM rows, or content trackers.

Example prompt

"Add three new rows to the Content Ideas database with titles, and set status to Draft"

Auto-Generated Pages

Let the AI create meeting notes or summaries as new pages in the right location.

Example prompt

"Create a new page in the Meetings database titled 'Product Sync Oct 15' with today's discussion summary"

// About

Plain English

Imagine asking your AI: 'Add a new row to my tasks database with due date Friday' or 'Find all docs about the Q3 roadmap and summarize them' — and it edits your Notion workspace directly. This server connects your AI to Notion so it can search, read, create, and update pages, databases, and blocks.

The official Notion MCP server connects AI assistants to your Notion workspace. Search pages, create and update content, query databases, and manage your knowledge base — all through conversation.

Maintained by Notion with official API support. Ideal for teams using Notion as their primary knowledge management system.

GitHub 4.5kUpdated Feb 11, 2025MIT

View on GitHub Official Site