Notion MCP Server

基本能力

产品定位

Notion MCP Server 是一个桥梁工具，连接 AI 助手（如 Claude）和 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. 下载仓库到您的计算机
2. 使用 Git: git clone [repository-url]

3. 或下载并解压 ZIP 文件

4. 打开命令提示符或终端

5. 导航到下载的仓库文件夹: cd path/to/notion-mcp-server

6. 安装依赖项: npm install

7. 创建配置文件:

8. 复制 .env.example 并重命名为 .env
9. 打开 .env 文件并替换 your_notion_api_key_here 为您的 Notion API 密钥
10. 保存文件

调试方式

1. 启动 Claude 中的新对话
2. 要求 Claude 与您的 Notion 工作空间交互，例如:
3. "Show me a list of my Notion databases"
4. "Create a new page in my Tasks database with title 'Test Task'"

许可证

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