What dependencies or runtime are required?

You need Node.js and npm installed. The README instructs to run `npm install` and `npm run build` before starting the server.

How do I troubleshoot if tools are not appearing?

Check the Claude for Desktop logs with `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log`. Ensure your Notion API key is correct and that your integration has been granted access to the relevant pages or databases.

SSyncDev

Start a project

Notion MCP Server

# Notion MCP Server A Model Context Protocol server for Notion integration, allowing Claude and other LLMs to interact with your Notion workspace. ##

Local serverstdio

What is the Notion MCP Server?

Notion MCP Server A Model Context Protocol server for Notion integration, allowing Claude and other LLMs to interact with your Notion workspace. Features -

What the server does

Search Notion — Search across your entire Notion workspace
Get Page — Retrieve content from a specific Notion page
Create Page — Create new pages in your Notion workspace
Update Page — Update existing pages with new content or titles
Create Database — Create new databases with custom properties
Query Database — Query databases with filters and sorting

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Notion MCP Server

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/Users/shaheerahmad/Documents/notion-mcp-server/dist/index.js",
        "--notion-api-key=YOUR_ACTUAL_API_KEY_HERE"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Frequently asked questions

Open the Claude for Desktop configuration file (on macOS at `~/Library/Application Support/Claude/claude_desktop_config.json`) and add the Notion server entry with the command `node`, the path to the built `index.js`, and your Notion API key as `--notion-api-key=YOUR_KEY`.