remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for reading, creating, and modifying Notion content through natural language interactions, including page operations (creation, archiving, restoration, searching), block operations (retrieval, appending, updating, deleting), and batch operations for efficient content management.

Not MCP 服务器

Notion MCP 服务器是一个模型上下文协议 (MCP) 服务器实现，使 AI 助手能够与 Notion 的 API 进行交互。这款生产就绪的服务器提供了一整套工具和端点，用于通过自然语言交互读取、创建和修改 Notion 内容。

🚧积极开发：数据库支持现已推出！评论和用户管理工具也已添加。如果您觉得这个项目有用，请考虑点个星——这有助于我了解这项工作对社区的价值，并激励我们进一步开发。

🚀 入门与集成

设置过程

获取 Not API 密钥
- 在Notion Developers上创建集成
- 复制您的 API 密钥
为您的页面启用集成
- 在 Notion 中选择一个现有页面或创建一个新页面
- 点击右上角的“...”菜单
- 前往“连接”
- 从列表中查找并启用您的集成
选择您的集成方法
- 根据您首选的 MCP 客户端，遵循以下集成选项之一
让你的人工智能助手与 Notion 互动
- “创建一个包含今日任务的新页面”
- “在 Notion 中更新我的会议记录”
- “将项目符号添加到我的会议记录页面”
- “创建一个新的数据库来跟踪项目”
- “向我的任务数据库添加新条目”
- “向我的项目页面添加评论”
- “显示此文档的所有评论”
- “列出我的工作区中的所有用户”
- “获取特定用户的信息”

光标集成

方法 1：使用 mcp.json

在您的项目目录中创建或编辑.cursor/mcp.json文件：

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx",
      "args": ["-y", "notion-mcp-server"]
    }
  }
}

用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID
重新启动 Cursor 以应用更改

方法二：手动模式

打开 Cursor 并转到“设置”
导航到“MCP”或“模型上下文协议”部分
单击“添加服务器”或同等按钮
在相应的字段中输入以下命令：

env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server

用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID
保存设置并根据需要重新启动 Cursor

Claude 桌面集成

在您的配置目录中创建或编辑mcp.json文件：

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_KEY",
        "NOTION_PAGE_ID": "YOUR_PAGE_ID"
      }
    }
  }
}

用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID
重新启动 Claude Desktop 以应用更改

🌟 功能

📝 Notion 集成- 与 Notion 数据库、页面和块进行交互
🔌 通用 MCP 兼容性- 适用于所有 MCP 客户端，包括 Cursor、Claude Desktop、Cline 和 Zed
🔍 数据检索- 从 Notion 页面、块和数据库获取信息
✏️ 内容创建- 创建和更新 Notion 页面和区块
📊 区块管理- 在 Notion 页面中附加、更新和删除区块
💾 数据库操作- 创建、查询和更新数据库
🔄 批量操作- 在单个请求中执行多个操作
🗑️ 存档和恢复- 存档和恢复 Notion 页面
🔎 搜索功能- 按标题搜索 Notion 页面和数据库
💬 评论管理——获取、创建和回复页面和讨论的评论
👥 用户管理- 检索工作区用户和用户信息

📚 文档

可用工具

该服务器提供了以下与 Notion 交互的整合工具：

`notion_pages`

全面的页面操作工具，包括：

创建具有指定内容的新页面
更新页面属性
存档页面（移至垃圾箱）
恢复之前存档的页面
按标题搜索页面

示例操作：

{
  "payload": {
    "action": "create_page", // One of: "create_page", "archive_page", "restore_page", "search_pages", "update_page_properties"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_blocks`

完整的区块操作工具包包括：

检索块内容
获取子块
将新块附加到父块
更新现有区块
删除块
执行批量操作（追加、更新、删除、混合）

示例操作：

{
  "payload": {
    "action": "append_block_children", // One of: "append_block_children", "retrieve_block", "retrieve_block_children", "update_block", "delete_block", "batch_append_block_children", "batch_update_blocks", "batch_delete_blocks", "batch_mixed_operations"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_database`

用于数据库交互的强大工具，包括：

使用自定义属性创建新数据库
使用过滤器和排序查询数据库
更新数据库结构和属性

示例操作：

{
  "payload": {
    "action": "create_database", // One of: "create_database", "query_database", "update_database"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_comments`

用于管理 Notion 内容评论的工具：

从页面和区块中检索评论
向页面添加新评论
回复现有讨论

示例操作：

{
  "payload": {
    "action": "get_comments", // One of: "get_comments", "add_page_comment", "add_discussion_comment"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

`notion_users`

访问用户信息的工具：

列出所有工作区用户
获取特定用户的详细信息
检索有关当前机器人用户的信息

示例操作：

{
  "payload": {
    "action": "list_users", // One of: "list_users", "get_user", "get_bot_user"
    "params": {
      // Parameters specific to the chosen action
    }
  }
}

可用资源

服务器目前不公开任何资源，而是专注于基于工具的操作。

🛠 开发

克隆存储库
git clone https://github.com/awkoy/notion-mcp-server.git cd notion-mcp-server
安装依赖项
npm install
设置环境变量
- 创建.env文件：
  NOTION_TOKEN=your_notion_api_key NOTION_PAGE_ID=your_notion_page_id
构建项目
npm run build
运行检查器
npm run inspector

🔧 技术细节

使用 TypeScript 和 MCP SDK（版本 1.7.0+）构建
使用官方 Notion API 客户端（@notionhq/client v2.3.0+）
遵循模型上下文协议规范
实现对 Notion 页面、块和数据库进行 CRUD 操作的工具
支持高效的批量操作，以优化性能
使用 Zod 模式验证输入/输出

❓ 故障排除

常见问题
- 身份验证错误：确保您的 Notion 令牌具有正确的权限，并且已为您的页面/数据库启用集成
- 页面访问问题：确保您的集成已添加到您尝试访问的页面
- 速率限制：Notion API 有速率限制 - 使用批处理操作来优化请求
获取帮助
- 在GitHub 存储库上创建问题
- 查看Notion API 文档
- 访问 MCP 社区频道寻求帮助