Notion MCP Server

A Model Context Protocol server wrapping the official Notion SDK

Catalog onlyCatalog onlySTDIO

Overview

Notion MCP Server is a Model Context Protocol server that wraps the official Notion SDK, enabling AI models to interact seamlessly with Notion workspaces.

To use the Notion MCP Server, set up your Notion integration by creating a new integration on Notion, copying the API key, and adding it to your AI assistant's MCP server configuration.

Full support for the Notion API through the official SDK. - MCP compliant for easy integration with AI models. - Tools for searching, querying databases, managing pages, and handling user information. - Robust error handling and detailed logging options.

Integrating AI models with Notion for enhanced productivity.
Automating content management tasks within Notion workspaces.
Enabling AI-driven insights and data retrieval from Notion databases.

Add to your AI client

Use these steps to connect Notion MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-notion-ramidecodes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-notion-ramidecodes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-notion-ramidecodes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-notion-ramidecodes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-notion-ramidecodes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-notion-ramidecodes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-notion-ramidecodes"
      ]
    }
  }
}

FAQ

How do I set up the Notion integration?

Go to Notion's integration page, create a new integration, and copy the API key.

Can I use environment variables for configuration?

Yes! You can set the API key in a `.env` file for easier management.

What should I do if I encounter errors?

Check the troubleshooting section for common issues and solutions.

Developer tools