MCP Notion

Source

This project implements a MCP (Model Context Protocol) server that allows language models such as Claude to interact directly with Notion. It serves as a standardized interface between LLMs and the Notion API, eliminating the need for intermediate layers such as Supabase.

Catalog onlyCatalog onlySTDIO

Overview

MCP Notion is a server implementing the Model Context Protocol (MCP) that allows language models to interact directly with the Notion API, providing a standardized interface without the need for intermediate layers.

To use MCP Notion, clone the repository, set up your environment variables with your Notion API key, and run the server. You can then interact with Notion databases and pages through the provided API endpoints.

Search functionality in Notion - Retrieve pages and their content - Query databases - CORS support - Robust error handling - Integrated logging

Integrating language models with Notion for enhanced data interaction.
Automating data retrieval from Notion databases.
Building applications that require seamless interaction with Notion content.

Add to your AI client

Use these steps to connect MCP Notion 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-notion-gsusfc": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-notion-gsusfc"
      ]
    }
  }
}

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-notion-gsusfc": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-notion-gsusfc"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

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-notion-gsusfc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-notion-gsusfc"
      ]
    }
  }
}

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

What are the prerequisites for using MCP Notion?

You need Rust (latest stable version), a Notion API token, and existing databases or pages in Notion to interact with.

How do I install MCP Notion?

Clone the repository, configure your environment variables, and run the server using Cargo.

Can I contribute to MCP Notion?

Yes! You can fork the project, create a feature branch, and submit a pull request.

Developer tools