MCP Server for Notion

This tool provides the Notion API as an MCP (Model Context Protocol) server.It enables AI agents to search, view, create, and updateNotion pages, as well as operate on databases.

Features

Page & Database Operations

Supports major operations such as search, retrieval, creation, updates, and appending blocks.

File-based Operations

Drastically reduces LLM token usage by saving/loading page content (JSON) to/from files.

Response Extraction (extract)

Optimizes context size by extracting only the necessary properties from the API response.

Quick Start

Local Development Environment

Install:

git clone https://github.com/acckkiie/notion-mcp-server
cd notion-mcp-server
npm install

Configure:Copy .env.example to create .env and set your Notion API key.
```
cp .env.example .env
# Edit .env: NOTION_API_KEY=secret_...
```
Run:
```
npm run dev
```

Image Build

npm run build
docker build -t notion-mcp-server:latest .

MCP Client Configuration

Via Docker (Recommended)

Using Docker reduces environment dependencies and enables security control via proxy.

{
  "mcpServers": {
    "notion-mcp-server": {
      "disabled": false,
      "command": "bash",
      "args": [
        "-c",
        "docker compose -f /path/to/notion-mcp-server/docker-compose.yml down 2>/dev/null; docker compose --env-file /path/to/notion-mcp-server/.env -f /path/to/notion-mcp-server/docker-compose.yml run --rm -i notion-mcp-server"
      ],
      "env": {
        "HOST_WORKSPACE_PATH": "/path/to/your/workspace"
      }
    }
  }
}

Local Execution

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/path/to/notion-mcp-server/build/index.js"
      ],
      "env": {
        "NOTION_API_KEY": "secret_...",
        "HOST_WORKSPACE_PATH": "/path/to/your/workspace"
      }
    }
  }
}

License

GNU Affero General Public License v3.0 (AGPL-3.0)

MCP Server for Notion