Notion MCP Server

基本能力

产品定位

Notion MCP Server 是一个桥梁工具，连接 AI 助手（如 Claude）和 Notion 工作空间，实现 AI 对 Notion 内容的查看、搜索、创建和更新等功能。

核心功能

• 查看和搜索 Notion 数据库
• 创建和更新页面
• 管理内容块
• 创建和修改数据库结构
• 搜索工作空间内容

适用场景

• AI 助手与 Notion 的集成
• 自动化管理 Notion 内容
• 通过 AI 快速创建和更新 Notion 页面

工具列表

• list-databases: 查看所有可访问的数据库
• query-database: 从数据库获取条目
• create-page: 向数据库添加新页面
• update-page: 修改现有页面
• create-database: 创建新数据库
• update-database: 修改数据库结构
• get-page: 查看特定页面
• get-block-children: 查看内容块
• append-block-children: 向页面添加内容
• update-block: 编辑内容块
• get-block: 查看特定块
• search: 在工作空间中搜索内容

常见问题解答

1. "Connection failed" in Claude
2. 确保 claude_desktop_config.json 中的服务器路径正确
3. 检查 Notion API 密钥是否有效

4. 确保 Node.js 已安装

5. "Access denied" when accessing Notion content

6. 确保已将页面/数据库与您的集成共享

7. 检查 API 密钥是否具有必要的权限

8. Server won't start

9. 确保所有依赖项已安装 (npm install)
10. 检查 .env 文件是否存在并包含 API 密钥

使用教程

使用依赖

• Node.js (版本 14 或更高)
• Notion 账户
• Claude Desktop 应用（如果与 Claude 一起使用）

安装教程

1. 获取 Notion API 密钥
2. 访问 https://www.notion.so/my-integrations

3. 创建新集成并复制 API 密钥

4. 设置服务器

5. 下载或克隆仓库
6. 导航到项目目录

7. 安装依赖项 npm install

8. 连接到 Notion 页面

9. 在 Notion 中共享页面/数据库与您的集成

10. 连接到 Claude Desktop

11. 修改 Claude Desktop 配置文件以包含服务器路径和 API 密钥

12. 测试连接

13. 在 Claude 中启动新对话并尝试与 Notion 交互

调试方式

• 检查控制台输出以获取错误消息
• 确保 Notion API 密钥有效
• 验证集成是否有权访问页面/数据库

许可证

该项目遵循 MIT 开源许可条款。