使用说明
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内部集成令牌来自 我的集成
建立观念整合
- 首选 notion.so/my集成
- 点击“新建集成”
- 为其命名并选择工作区
- 复制内部集成令牌
- 通过集成共享目标页面/数据库
安装
通过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服务器。
关注我们的进展并获取更新:
- X(推特): @cloud9_ai_labs
- GitHub: cloud9实验室
许可证
麻省理工学院