Notion AI连接器

你是否曾经希望AI能够直接访问你的Notion工作区，自动管理数据库、创建页面、搜索内容？今天要介绍的开源项目Notion AI连接器，正是为了实现这个目标而设计的。它是一个MCP服务器，将AI助手连接到您的Notion工作区，允许人工智能与数据库、页面和块进行交互。

项目基本信息

一、项目介绍

Notion AI连接器是一个让AI能够与Notion工作区交互的MCP工具。它支持查看和搜索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：在整个工作区查找内容

二、核心优势

完整API覆盖

提供12个工具，覆盖Notion核心功能。

易于集成

与Claude Desktop无缝集成。

安全访问

通过API密钥和页面共享控制访问权限。

全面操作

支持数据库、页面、块的完整CRUD。

开源免费

MIT许可证，可自由使用。

三、适用场景

知识库管理

让AI自动整理和更新Notion知识库。

任务自动化

AI可以自动创建和更新任务页面。

内容创作

AI可以直接在Notion中撰写和编辑内容。

数据整理

AI可以查询和分析Notion数据库中的数据。

四、安装教程

系统要求

安装步骤

第一步：获取Notion API密钥

1. 访问 https://www.notion.so/my-integrations
2. 点击"New integration"
3. 填写名称，选择工作区
4. 复制生成的令牌（以secret_开头）

第二步：下载项目

git clone https://github.com/Sjotie/notionMCP.git
cd notionMCP
npm install

第三步：共享页面给集成

在Notion中，为每个需要AI访问的页面/数据库：

1. 点击右上角的"..."
2. 选择"添加连接"
3. 选择你创建的集成

第四步：配置Claude Desktop

找到配置文件：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["C:\\path\\to\\notionMCP\\server.js"],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key"
      }
    }
  }
}

第五步：重启Claude Desktop

保存配置后，重启Claude Desktop。

五、使用示例

示例1：列出数据库

用户指令：“显示我的Notion数据库列表”

AI会调用list-databases工具。

示例2：查询数据库

用户指令：“从任务数据库中获取所有未完成的任务”

AI会调用query-database工具。

示例3：创建页面

用户指令：“在我的任务数据库中创建一个标题为'测试任务'的新页面”

AI会调用create-page工具。

示例4：更新页面

用户指令：“将页面标题改为'已完成的任务'”

AI会调用update-page工具。

示例5：搜索内容

用户指令：“搜索整个工作区中的'项目计划'”

AI会调用search工具。

六、常见问题

问题1：连接失败

解决方案：检查server.js路径是否正确，API密钥是否有效。

问题2：访问被拒绝

解决方案：确保已将页面/数据库共享给集成。

问题3：服务器无法启动

解决方案：运行npm install确保依赖已安装。

问题4：Node.js版本

解决方案：需要Node.js 14或更高版本。

问题5：Windows路径格式

解决方案：使用双反斜杠\\。

七、总结

Notion AI连接器是一个让AI能够与Notion工作区交互的MCP工具，提供完整的数据库、页面和块管理功能。

这个项目的最大价值在于：

1. 功能完整：12个工具覆盖Notion核心功能
2. 易于集成：与Claude Desktop无缝配合
3. 安全访问：API密钥和页面共享控制
4. 全面操作：数据库、页面、块的CRUD
5. MIT许可证：可自由使用

如果你使用Notion管理知识和任务，Notion AI连接器是一个非常实用的工具。