Notion MCP Server

Notion MCP Server

site icon
2025.04.17 1255
TypeScriptNotion集成自动化工具内容管理交流协作
Notion MCP Server 是一个实现了 MCP 服务器协议的项目,专门用于与 Notion API 进行交互。它允许开发者通过 MCP 协议调用 Notion API 的功能,实现自动化操作 Notion 页面、数据库等资源。
View on GitHub

Overview

基本能力

产品定位

Notion MCP Server 是一个中间件服务,旨在通过 MCP 协议桥接 AI 工具与 Notion API,实现自动化操作 Notion 内容。

核心功能

  1. 实现 MCP 服务器协议,支持通过指令操作 Notion API
  2. 支持搜索 Notion 页面和数据库
  3. 支持在页面上添加评论
  4. 支持创建新页面
  5. 支持获取特定页面内容

适用场景

  1. 自动化管理 Notion 内容
  2. AI 辅助的 Notion 内容操作
  3. 批量处理 Notion 页面和数据库
  4. 集成 Notion 功能到其他应用程序中

工具列表

  1. npx - 用于执行 Notion MCP Server
  2. npm - 用于构建和发布项目

常见问题解答

  1. 如何获取集成密钥?
  2. 从 Notion 集成配置页面获取
  3. 如何连接页面和数据库到集成?
  4. 确保在 Notion 中已将相关页面和数据库连接到你的集成

使用教程

使用依赖

  1. 需要安装 Node.js 和 npm
  2. 需要有效的 Notion 集成密钥

安装教程

  1. 在配置文件中添加以下内容(.cursor/mcp.jsonclaude_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\" }"
      }
    }
  }
}
  1. 替换 ntn_**** 为你的集成密钥

调试方式

  1. 本地构建:
npm run build
  1. 本地执行:
npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server
  1. 发布:
npm publish --access public

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。