Notion MCP Server

The Notion MCP server connects Claude to your Notion workspace via the official Notion API. You can search across all pages, read database entries, create new pages, update properties, and append blocks — making it easy to use Claude as a writing and research assistant directly inside your knowledge base.

Prerequisites

• Node.js 18+
• Notion Internal Integration Token — create one at notion.so/my-integrations
• You must share each page or database with your integration (the "Connect to" menu in Notion's top-right)

Installation & Configuration

Add this block to your claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notion"],
      "env": {
        "NOTION_API_KEY": "secret_yourIntegrationTokenHere"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

Available Tools (6)

• search
  Full-text search workspace
• get_page
  Read a page and its blocks
• query_database
  Filter and sort a database
• create_page
  Create a new page or entry
• update_page
  Update page properties
• append_block_children
  Add content blocks to a page

Use Cases

• Ask Claude to summarise all meeting notes from last month
• Create a new task in your project database from a chat message
• Draft a document in Claude and append it to an existing Notion page

Tips & Gotchas

Source & Documentation