Notion

🚀 Notion MCP 服务器

Notion MCP 服务器基于 Notion API 构建，它能够让 Claude 与 Notion 工作区进行互动协作，为您的工作流程提供强大助力。

✨ 主要特性

• 提供多种工具集，方便对 Notion 的块、页面、数据库等进行操作。
• 支持与 Claude Desktop 集成，通过配置文件即可轻松使用。

📦 安装指南

文档中未提及具体安装步骤，可补充相关内容以方便用户使用。

💻 使用示例

基础用法

以下是使用notion_append_block_children工具向父块添加子块的示例：

# 假设这里有调用 notion_append_block_children 的代码
# 由于未提供实际代码，此处仅作示例示意
# 调用 notion_append_block_children 函数，传入父块 ID 和子块对象数组
result = notion_append_block_children(block_id="your_block_id", children=[{"type": "paragraph", "paragraph": {"text": [{"type": "text", "text": {"content": "This is a new child block."}}]}}])
print(result)

高级用法

在搜索内容时，使用可选参数进行分页搜索：

# 假设这里有调用 notion_search 的代码
# 由于未提供实际代码，此处仅作示例示意
# 调用 notion_search 函数，传入搜索关键词、每页结果数量和游标
result = notion_search(query="your_search_query", page_size=20, cursor="your_cursor")
print(result)

📚 详细文档

工具集

1. notion_append_block_children

• 功能：向父块添加子块。
• 必填输入：
  • block_id (字符串)：父块的 ID。
  • children (数组)：待添加的子块对象数组。
• 返回信息：关于已添加块的详细信息。

2. notion_retrieve_block

• 功能：获取特定块的信息。
• 必填输入：
  • block_id (字符串)：要获取的块 ID。
• 返回信息：块的详细信息。

3. notion_retrieve_block_children

• 功能：获取特定块的子块。
• 必填输入：
  • block_id (字符串)：父块的 ID。
• 可选输入：
  • start_cursor (字符串)：下一页结果的游标。
  • page_size (数字，默认值：100，最大值：100)：获取的块数量。
• 返回信息：子块列表。

4. notion_delete_block

• 功能：删除特定块。
• 必填输入：
  • block_id (字符串)：要删除的块 ID。
• 返回信息：删除确认。

5. notion_retrieve_page

• 功能：获取特定页面的信息。
• 必填输入：
  • page_id (字符串)：要获取的页面 ID。
• 返回信息：页面的详细信息。

6. notion_update_page_properties

• 功能：更新页面属性。
• 必填输入：
  • page_id (字符串)：要更新的页面 ID。
  • properties (对象)：待更新的属性。
• 返回信息：已更新页面的信息。

7. notion_create_database

• 功能：创建新数据库。
• 必填输入：
  • parent (对象)：数据库的父级对象。
  • title (数组)：数据库标题。
  • properties (对象)：数据库属性。
• 返回信息：创建成功的数据库 ID。

8. notion_retrieve_databases

• 功能：获取所有数据库。
• 无必填输入。
• 返回信息：数据库列表。

9. notion_update_database_properties

• 功能：更新数据库属性。
• 必填输入：
  • database_id (字符串)：要更新的数据库 ID。
  • properties (对象)：待更新的属性。
• 返回信息：已更新数据库的信息。

10. notion_delete_database

• 功能：删除数据库。
• 必填输入：
  • database_id (字符串)：要删除的数据库 ID。
• 返回信息：删除确认。

11. notion_search

• 功能：搜索内容。
• 必填输入：
  • query (字符串)：搜索关键词。
• 可选输入：
  • page_size (数字)：每页结果数量。
  • cursor (字符串)：游标用于分页。
• 返回信息：搜索结果。

配置指南

若要通过Claude Desktop使用，请在claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["your-built-file-path"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

故障排除

若遇权限错误：

1. 确保集成具备所需权限。
2. 验证集成是否已添加到相关页面或数据库。
3. 核实令牌及配置在claude_desktop_config.json中设置正确。

📄 许可证

该 MCP 服务器基于 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。如需更多详情，请参阅项目仓库中的 LICENSE 文件。