Notion 工作空间0

产品介绍

Notion 工作区是一个协作式工作环境，团队/个人可在此以高度定制化的方式组织工作、管理项目及存储信息。该项目为 Notion API 实现了一个 MCP 服务器，提供对 Notion API 的全面访问，使 AI 助手能够与 Notion 数据库、页面、区块及搜索功能进行交互。所有工具均包含完善的错误处理机制，操作失败时将返回用户友好的错误提示。

核心功能

• (01) 数据库操作：列表展示、查询、创建、更新 Notion 数据库
• (02) 页面操作：获取、创建、更新 Notion 页面
• (03) 区块操作：获取区块内容、查询子区块、追加区块、更新区块内容
• (04) 全局搜索：可访问的页面和数据库中执行搜索

配置 Notion MCP

(1) 获取 API Key 和 (2) 访问权限设置

访问 https://www.notion.so/profile/integrations 并创建新的 "内部集成 Key (New Integration)" 或者选择 "现有集成 Key (Integration)"

• (01) 选择 New Integration
• (02) 选择用户想操控的工作空间 (Associated Workspace)
• (03) 选择 Type → Internal
• (04) 选择保存 (Save)

尽管 Notion MCP 已限制暴露的 Notion API 范围（e.g. 用户将无法通过 MCP 删除数据库），但将工作区数据暴露给大型语言模型 (LLM) 仍存在一定风险。注重数据安全的用户可进一步调整集成权限配置。

操作案例 (权限配置 → 只可阅读)：

• (01) 进入集成管理的「配置页面」(Configuration → Capabilities)
• (02) 勾选「内容能力」(Content Capabilities) 中的只可阅读不可修改 (Read Content) 选项

Notion MCP 权限设置选项列表 (对应以下图片):

• 内容权限：读取内容、更新内容、插入内容
• 评论权限：读取评论、添加评论
• 工作空间权限：用户之间的 Notion 内容转移
• 用户信息权限：不请求用户信息、申请访问用户信息 (不包含邮箱地址)、申请访问用户信息 (包含邮箱地址）

最后，请确保将相关用户想通过 MCP 和 LLM 操作的页面/数据库与用户的的集成 Key 建立连接，此处仍然需要用户手动选择可以访问/不可以访问的页面。

• (1) 访问用户的内部集成 (Integrations) 设置页面
• (2) 选择「访问权限」(Access) 选项
• (3) 点击 "编辑访问权限" (Edit Access)
• (4) 勾选用户需要使用的特定页面

JSON 快速导入

在 JSON 导入中，请务必将代码中的 "ntn_****" 替换为用户的集成密钥（Integration Key）

工具介绍

数据库工具

• list_databases - 列出集成可访问的所有数据库
• query_database - 查询数据库（支持筛选、排序和分页）
• create_database - 在父页面中创建新数据库
• update_database - 更新现有数据库的标题、描述或属性

页面工具

• get_page - 根据ID获取页面
• create_page - 在数据库或父页面下创建新页面
• update_page - 更新现有页面的属性或归档状态

区块工具

• get_block - 根据ID获取区块
• get_block_children - 获取区块（页面或区块）的子区块
• append_block_children - 向父区块（页面或区块）追加子区块
• update_block - 更新区块内容或归档状态

搜索工具

• search - 在集成可访问的所有页面和数据库中搜索

申请 Notion Integration：Key 地址