Notion MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Notion MCP Server 是一个连接 AI 助手与 Notion 平台的中间件，通过 MCP 协议实现自然语言驱动的 Notion 内容管理。

核心功能

• Notion 集成：与 Notion 数据库、页面和块进行交互
• 数据检索：从 Notion 页面、块和数据库中获取信息
• 内容创建：创建和更新 Notion 页面和块
• 块管理：在 Notion 页面中追加、更新和删除块
• 数据库操作：创建、查询和更新数据库
• 批处理操作：在单个请求中执行多个操作
• 归档与恢复：归档和恢复 Notion 页面
• 搜索功能：按标题搜索 Notion 页面和数据库
• 评论管理：获取、创建和回复页面和讨论的评论
• 用户管理：检索工作区用户和用户信息

适用场景

• 通过自然语言指令管理 Notion 内容
• 自动化 Notion 页面和数据库的创建与更新
• 批量处理 Notion 内容操作
• 集成到 AI 助手或开发工具中增强 Notion 交互能力

工具列表

页面操作

• create_page：创建新页面
• update_page_properties：更新页面属性
• archive_page：归档页面
• restore_page：恢复页面
• search_pages：按标题搜索页面

数据库操作

• create_database：创建新数据库
• query_database：查询数据库
• update_database：更新数据库

块操作

• retrieve_block：检索块
• retrieve_block_children：检索块的子块
• append_block_children：追加子块
• update_block：更新块内容
• delete_block：删除块

批处理操作

• batch_append_block_children：批量追加子块
• batch_update_blocks：批量更新块
• batch_delete_blocks：批量删除块
• batch_mixed_operations：混合操作

评论操作

• get_comments：获取评论
• add_page_comment：添加页面评论
• add_discussion_comment：添加讨论评论

用户操作

• get_list_users：获取用户列表
• get_user：获取用户信息
• get_bot_user：获取当前机器人用户

常见问题解答

• 认证错误：确保 Notion token 有正确权限且集成已启用
• 页面访问问题：确保集成已添加到尝试访问的页面
• 速率限制：使用批处理操作优化请求

使用教程

使用依赖

1. 安装 Node.js 和 npm
2. 获取 Notion API 密钥

安装教程

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

2. 安装依赖
   npm install

3. 设置环境变量
   创建 .env 文件并添加：
   NOTION_TOKEN=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

4. 构建项目
   npm run build

5. 运行检查器
   npm run inspector

调试方式

1. 检查环境变量是否正确设置
2. 验证 Notion 集成是否已添加到目标页面
3. 使用检查器调试操作
   npm run inspector