Notion MCP Server

基本能力

产品定位

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于连接 AI 助手与 Notion 工作区。它提供了一个标准化的接口，使大型语言模型 (LLMs) 能够以编程方式访问和操作 Notion 内容，包括数据库、页面和块。

核心功能

1. 数据库操作
2. 查询数据库（支持过滤和排序）
3. 创建具有自定义属性的新数据库
4. 更新现有数据库的架构和属性

5. 跨数据库搜索

6. 页面操作

7. 创建具有属性和内容的页面
8. 检索页面内容和元数据
9. 更新页面属性

10. 跨页面搜索

11. 块操作（即将推出）

12. 检索块的子项
13. 向页面追加新块
14. 更新块内容
15. 删除块

适用场景

• AI 助手帮助用户管理 Notion 工作区
• 自动化 Notion 内容的创建和更新
• 跨 Notion 数据库的复杂查询和搜索

工具列表

1. 数据库工具
2. queryDatabase: 查询 Notion 数据库（支持过滤和排序）
3. createDatabase: 在 Notion 中创建新数据库

4. updateDatabase: 更新数据库的属性或架构

5. 页面工具

6. retrievePage: 获取页面的内容和属性
7. createPage: 在 Notion 中创建新页面

8. updatePageProperties: 更新页面的属性

9. 搜索工具

10. search: 按标题在 Notion 工作区中搜索

常见问题解答

• 权限错误: 确保您的 Notion 集成具有所需的权限，并已邀请到相关页面或数据库。
• 配置问题: 确认您的令牌已正确设置在 .env 文件或配置中。

使用教程

使用依赖

1. 安装 Bun v1.2.9 或更高版本
2. 获取具有适当权限的 Notion 集成令牌
3. 将 Notion 页面/数据库与您的集成共享

安装教程

1. 克隆仓库: bash git clone https://github.com/kyrelldixon/notion-mcp.git cd notion-mcp

2. 安装依赖: bash bun install

3. 在项目根目录创建 .env 文件: NOTION_API_KEY=your_notion_integration_token

4. 构建并运行服务器: bash bun run src/index.ts

调试方式

1. 确保您的 Notion 集成具有所需的权限
2. 验证集成是否已邀请到相关页面或数据库
3. 确认您的令牌已正确设置在 .env 文件或配置中

许可证

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