home / mcp / notion mcp server

Notion MCP Server

Global Notion workspace-accessible MCP server for all Notion pages within the workspace

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "seonglae-mcp-notion": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

You can browse and manage your entire Notion workspace through a dedicated MCP server that converts Notion pages into Markdown notes, lets you search across related pages, and exposes pages as light-weight notes with metadata for easy retrieval.

How to use

You connect to the MCP server from your MCP client and start requesting pages, searches, and summaries. Each Notion page becomes a note:// URI with a UUID slug, and content is available in text/markdown format. Use the search capability to find relevant pages by query text, then open or summarize specific notes directly from your client. You can navigate the workspace by following parent-child relationships and references between Notion pages.

How to install

Prerequisites: ensure you have Node.js and a package manager installed on your system.

pnpm install
pnpm build

# For development with auto-rebuild
pnpm watch

# Optional: start debugging inspector
pnpm inspector

Configuration and usage notes

Configure the server by setting the root Notion page you want to browse. This is done through environment variables.

{
  "mcpServers": {
    "notion_texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

Security and debugging

If you need troubleshooting, you can use the MCP Inspector to inspect server interactions. Start the inspector from your project root to access a browser-based interface for stdio-based server communication.

pnpm inspector

Claude Desktop integration example

To use this MCP server with Claude Desktop, add a per-device configuration JSON entry that launches the server locally.

{
  "mcpServers": {
    "notion_texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

Available tools

search_notes

Search Notion pages using a query string and return the matching notes in Markdown format.

summarize_note

Generate a concise summary for a specific Notion page identified by its URI.

suggest_refactor

Suggest structural improvements to a Notion page to improve readability and navigation.

suggest_fix

Identify potential fixes for issues found in a Notion page's content or structure.

suggest_enhance

Recommend enhancements to improve the usefulness and clarity of a Notion page.