Notion MCP Server

Name: Notion MCP Server
Author: suekou

suekou

Get started Repository Website & docs

Connects Notion to MCP clients so agents can read and write pages and databases through the Notion API.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add notion-server-suekou --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' --env NOTION_MARKDOWN_CONVERSION='<NOTION_MARKDOWN_CONVERSION>' -- npx -y @suekou/mcp-notion-server

~/.codex/config.toml

[mcp_servers.notion-server-suekou]
command = "npx"
args = ["-y", "@suekou/mcp-notion-server"]
env = { NOTION_API_TOKEN = "<NOTION_API_TOKEN>", NOTION_MARKDOWN_CONVERSION = "<NOTION_MARKDOWN_CONVERSION>" }

# codex mcp add notion-server-suekou --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' --env NOTION_MARKDOWN_CONVERSION='<NOTION_MARKDOWN_CONVERSION>' -- npx -y @suekou/mcp-notion-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "notion-server-suekou": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>",
        "NOTION_MARKDOWN_CONVERSION": "<NOTION_MARKDOWN_CONVERSION>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "notion-server-suekou": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>",
        "NOTION_MARKDOWN_CONVERSION": "<NOTION_MARKDOWN_CONVERSION>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "notion-server-suekou": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>",
        "NOTION_MARKDOWN_CONVERSION": "<NOTION_MARKDOWN_CONVERSION>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "notion-server-suekou": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>",
        "NOTION_MARKDOWN_CONVERSION": "<NOTION_MARKDOWN_CONVERSION>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "notion-server-suekou": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>",
        "NOTION_MARKDOWN_CONVERSION": "<NOTION_MARKDOWN_CONVERSION>"
      }
    }
  }
}

Environment variables

NOTION_API_TOKEN
NOTION_MARKDOWN_CONVERSION

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related