Notion MCP Server

Official

Read and write your Notion workspace from your AI assistant

notionproductivityknowledge-baseofficialnotes

The official Notion MCP server connects your AI assistant to your Notion workspace. Search pages, read content, create new pages, update existing ones, and manage databases — all through natural conversation. Authenticated via a Notion integration token with access only to the pages you choose to share. Ideal for knowledge workers who use Notion as their primary knowledge base and want AI to assist with research, writing, and organization.

Install Config

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json· Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "secret_your_token_here"
      }
    }
  }
}

Required environment variables:

NOTION_API_TOKEN — Notion internal integration token(e.g. secret_xxxxxxxxxxxxxxxxxxxx)

Available Tools (6)

Tool name	Description
notion_search	Search for pages and databases in Notion
notion_get_page	Retrieve the full content of a Notion page
notion_create_page	Create a new page in a database or as a subpage
notion_update_page	Update properties of an existing page
notion_append_blocks	Add content blocks to an existing page
notion_query_database	Query a Notion database with filters and sorts

Example Prompts

“Search my Notion for notes about project planning”
“Create a new page in my Meeting Notes database”
“What's in my 'Q2 Goals' page?”
“Add a summary of today's meeting to my notes”
“List all pages in my Engineering database”

Pros & Cons

Pros

Official Notion server — maintained by Notion's team
Full read and write access to your workspace
Granular access control — share only specific pages

Cons

Requires creating a Notion integration and sharing pages manually
Rate-limited by Notion API

Who Is This For?

·Knowledge workers who use Notion as their primary tool
·Teams who want AI to help search and update their shared knowledge base

When to use: Use when Notion is your knowledge base and you want AI to help you find information, write documents, or update databases without switching context.