Notion

在 ContexaAI 上部署，几分钟即可开始使用

重要说明

This repository is a fork of the official Notion MCP server available on NPM.
The primary modification is the replacement of the transport mechanism from Stdio to Server-Sent Events (SSE).

Notion MCP 服务

此项目为 Notion API 实现了一个 MCP 服务。

安装

1. 在 Notion 中设置集成：

访问 https://www.notion.so/profile/integrations，创建新的内部集成或选择已有集成。

虽然我们限制了所开放的 Notion API 范围（例如，你无法通过 MCP 删除数据库），但向大模型开放工作区数据仍存在一定风险。注重安全的用户可以进一步配置集成的_功能_。

例如，你可以在“Configuration”选项卡中仅授予“Read content”权限，以创建只读集成令牌：

2. 将内容连接到集成：

确保相关页面和数据库已连接到你的集成。

为此，你需要访问相应页面，点击 3 个点，然后选择“Connect to integration”。

3. 将 MCP 配置添加到客户端：

使用 npm：

将以下内容添加到 .cursor/mcp.json 或 claude_desktop_config.json（MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json）

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

使用 Docker：

使用 Docker 运行 MCP 服务有两种方式：

选项 1：使用官方 Docker Hub 镜像：

将以下内容添加到 .cursor/mcp.json 或 claude_desktop_config.json：

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

此方式：

• 使用官方 Docker Hub 镜像
• 通过环境变量妥善处理 JSON 转义
• 提供更可靠的配置方式

选项 2：在本地构建 Docker 镜像：

你也可以在本地构建并运行 Docker 镜像。首先，构建 Docker 镜像：

docker-compose build

然后，将以下内容添加到 .cursor/mcp.json 或 claude_desktop_config.json：

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server"
      ]
    }
  }
}

别忘了将 ntn_**** 替换为你的集成密钥。你可以在集成配置选项卡中找到它：

示例

1. 使用以下指令

Comment "Hello MCP" on page "Getting started"

AI 将正确规划两次 API 调用，即 v1/search 和 v1/comments，以完成任务

2. 类似地，使用以下指令会在父页面“Development”下创建一个名为“Notion MCP”的新页面

Add a page titled "Notion MCP" to page "Development"

3. 你也可以直接引用内容 ID

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

开发

构建

npm run build

执行

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

发布

npm publish --access public