AI导哈

Notion MCP服务器

这是一个将Notion API封装为MCP服务器的工具，使AI代理能够搜索、查看、创建和更新Notion页面与数据库，并通过文件操作和响应提取优化上下文使用。

  • by acckkiie
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 acckkiie/mcp-notion

使用说明

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 update Notion 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

  1. Install:

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

  2. Configure: Copy .env.example to create .env and set your Notion API key.

    cp .env.example .env
# Edit .env: NOTION_API_KEY=secret_...

  3. 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