home / mcp / notion mcp server

Notion MCP Server

MCP Server generated by mcp.ag2.ai

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "allisonwhilden-notion-api": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "JSON_STRING_CONFIG",
        "SECURITY": "SECURITY_PARAMETERS",
        "CONFIG_PATH": "PATH_TO_CONFIG_JSON"
      }
    }
  }
}

You can run a dedicated MCP server that exposes the Notion API via a controlled, multi-agent conversation interface. This server lets clients connect through different transport modes and manage configuration securely, enabling you to orchestrate conversations with the API in a scalable way.

How to use

Start the MCP server in stdio mode to interact directly from your local environment. You, as the client, will issue commands to the server and receive structured responses that coordinate between agents.

How to install

Prerequisites are Python 3.9 or newer and uv. Install Python packages and prepare the environment, then run the server.

pip install -e ".[dev]"
```

```
uv pip install --editable ".[dev]"

Additional content

Run and test the MCP server using the provided entry point. The server supports multiple transport modes such as stdio, sse, and streamable-http. You can tailor the startup to your workflow using configuration via files or environment variables. For safety and repeatability, keep sensitive values in environment variables and reference them from your configuration.