🚀 Notion MCP 服务器
Notion MCP 服务器是一个提供官方 Notion SDK 的 Model Context Protocol (MCP) 服务器，它允许 AI 模型与 Notion 工作区进行交互，为 AI 与 Notion 数据的结合提供了便利。
🚀 快速开始
1. 设置你的 Notion 集成
- 访问 https://www.notion.so/my-integrations。
- 创建一个新的集成。
- 复制 API 键。
2. 将你的 Notion 页面连接到集成
为了让你的集成访问 Notion 内容，你需要将页面或数据库显式地共享给它，具体步骤如下：
- 导航到你想通过集成访问的 Notion 页面或数据库。
- 点击右上角的“分享”按钮。
- 在“添加人员、组或集成”的字段中，从下拉列表中选择你的集成。
- 点击“邀请”。
- 重复上述步骤以共享每个页面或数据库。
⚠️ 重要提示
集成只能访问显式共享给它的页面和数据库。子页面会自动继承其父页面的权限。
3. 添加到你的 AI 助手
你可以将此 MCP 服务器添加到 Claude Desktop、Cursor AI 或 Claude.ai，使用以下配置格式之一：
命令行格式
npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key
JSON 配置格式
{
"mcpServers": {
"Notion": {
"command": "npx",
"args": [
"@ramidecodes/mcp-server-notion@latest",
"-y",
"--api-key=your-notion-integration-key"
]
}
}
}
请将 your-notion-integration-key 替换为你从步骤1复制的 API 键。
设置指南
- Claude Desktop：设置 > 高级 > 模型上下文协议
- Cursor AI：设置 > AI > MCP 服务器
- Claude.ai (Web)：个人资料 > 设置 > API 和集成 > 模型上下文协议
✨ 主要特性
该服务器提供与 Notion 交互的工具：
- 搜索：查找页面或数据库
- 数据库：查询和检索数据库条目
- 页面：创建、获取和删除页面
- 块：管理页面中的块内容
- 属性：操作页面的属性
有关每个工具的详细文档，请参阅 工具文档。
📦 安装指南
使用环境变量配置
创建一个名为 .env 的文件，并添加以下内容：
NOTION_API_KEY=your-notion-integration-key
然后在项目根目录运行命令以应用设置：
source .env
📄 许可证
本项目根据 Apache License 2.0 许可，具体请参阅 LICENSE 文件。