Notion API服务器

一个提供完整Notion API访问的模型上下文协议(MCP)服务器,允许从Claude、Cursor或任何MCP兼容客户端搜索、创建和管理数据库、页面、块和用户。

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

使用说明

MCP服务器概念

模型上下文协议(MCP)服务器,提供对Notion API的完全访问。直接从Claude、Cursor或任何兼容MCP的客户端搜索、创建和管理数据库、页面、块和用户。

特性

  • 搜索 -在所有页面和数据库中进行全文搜索
  • 数据库管理 -创建数据库,使用过滤器和排序进行查询
  • 页面管理 -创建、读取、更新和存档页面
  • 区块管理 -读取、附加和删除内容块
  • 用户访问 -列出工作区成员并获取用户详细信息
  • 内置速率限制 -自动节流(3个要求/秒),重试429次

可用工具(13)

工具 说明
notion_search 在所有页面和数据库中搜索
notion_get_database 获取数据库架构和详细信息
notion_query_database 使用过滤器和排序查询数据库
notion_create_database 在页面中创建新数据库
notion_create_page 在数据库或页面中创建新页面
notion_get_page 获取页面属性和元数据
notion_update_page 更新页面属性或存档
notion_get_block 按ID获取块
notion_get_block_children 获取页面或块的子块
notion_append_block_children 将内容块附加到页面
notion_delete_block 删除(存档)块
notion_list_users 列出所有工作区用户
notion_get_user 按ID获取用户详细信息

快速开始

npx @cloud9-labs/mcp-notion

先决条件

  • Node.js>=20.0.0
  • Notion内部集成令牌来自 我的集成

建立观念整合

  1. 首选 notion.so/my集成
  2. 点击“新建集成”
  3. 为其命名并选择工作区
  4. 复制内部集成令牌
  5. 通过集成共享目标页面/数据库

安装

通过npx(推荐)

无需安装-将MCP客户端配置为使用npx。

通过npm

npm i -g @cloud9-labs/mcp-notion

来源

git clone https://github.com/cloud9-labs/mcp-notion.git
cd mcp-notion
npm ci
npm run build

配置

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token_here"
      }
    }
  }
}

光标

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token_here"
      }
    }
  }
}

使用示例

  • “搜索有关营销的所有页面”
  • “查询任务数据库中分配给我的项目”
  • “在数据库abc123中创建一个标题为“会议笔记”的新页面”
  • “在xyz789页添加段落块”
  • “列出工作区中的所有用户”
  • “获取数据库def456的架构”

构建人工智能销售自动化系统?

此MCP服务器是用于AI驱动的销售自动化的开源工具包的一部分。我们正在构建连接您整个销售堆栈的MCP服务器。

关注我们的进展并获取更新:

许可证

麻省理工学院