Notion MCP 服务器

该项目实现了用于 Notion API 的 MCP 服务器。

安装

1. 在 Notion 中设置集成：

前往 https://www.notion.so/profile/integrations 并创建一个新的内部集成或选择一个现有的集成。

虽然我们限制了 Notion API 暴露的范围（例如，您将无法通过 MCP 删除数据库），但将工作区数据暴露给 LLMs 仍然存在一定的风险。安全意识强的用户可能希望进一步配置集成的_功能_。

例如，您可以通过仅从“配置”选项卡中给予“读取内容”访问权限来创建一个只读集成令牌：

2. 将 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 服务器。首先，构建 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-notion-mcp-server"
      ]
    }
  }
}

别忘了用您的集成密钥替换 ntn_****。可以从您的集成配置选项卡中找到它：

3. 将内容连接到集成：

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

为此，您需要访问该页面，点击三个点，然后选择“连接到集成”。

示例

1. 使用以下指令

Comment "Hello MCP" on page "Getting started"

AI 将正确规划两个 API 调用 v1/search 和 v1/comments 来完成任务。

1. 同样地，以下指令将在父页面“Development”下添加一个名为“Notion MCP”的新页面

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

1. 您也可以直接引用内容 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