Notion MCP Server

用于Notion API的MCP服务器，使Claude能够与Notion工作区进行交互。

工具

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 (对象)：数据库的属性模式。
   • 返回：关于创建的数据库的信息。

8. notion_query_database

   • 查询数据库。
   • 必需输入：
     • database_id (字符串)：要查询的数据库的ID。
   • 可选输入：
     • filter (对象)：过滤条件。
     • sorts (数组)：排序条件。
     • start_cursor (字符串)：结果下一页的游标。
     • page_size (数字，默认值：100，最大值：100)：要检索的结果数量。
   • 返回：来自查询的结果列表。

9. notion_retrieve_database

   • 获取特定数据库的信息。
   • 必需输入：
     • database_id (字符串)：要获取的数据库的ID。
   • 返回：关于该数据库的详细信息。

10. notion_update_database

    • 更新数据库信息。
    • 必需输入：
      • database_id (字符串)：要更新的数据库的ID。
    • 可选输入：
      • title (数组)：数据库的新标题。
      • description (数组)：数据库的新描述。
      • properties (对象)：更新的属性模式。
    • 返回：关于已更新数据库的信息。

11. notion_create_database_item

    • 在Notion数据库中创建新条目。
    • 必需输入：
      • database_id (字符串)：要添加条目的数据库的ID。
      • properties (对象)：新条目的属性。这些应符合数据库模式。
    • 返回：关于新创建条目的信息。

配置

以下是上述步骤的详细解释，请参阅以下文章：

• 英文版：https://dev.to/suekou/operating-notion-via-claude-desktop-using-mcp-c0h
• 日文版：https://qiita.com/suekou/items/44c864583f5e3e6325d9

1. 创建Notion集成

   • 访问Notion您的集成页面。
   • 点击“新建集成”。
   • 命名您的集成并选择适当的权限（例如，“读取内容”，“更新内容”）。

2. 获取密钥

   • 复制您的集成中的“内部集成令牌”。
   • 此令牌将用于身份验证。

3. 将集成添加到您的工作区

   • 打开您希望集成访问的Notion页面或数据库。
   • 点击右上角的导航按钮。
   • 点击“连接到”按钮并选择您的集成。

4. 配置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许可证发布。这意味着您可以自由地使用、修改和分发软件，但须遵守MIT许可证的条款和条件。如需更多详情，请参阅项目存储库中的LICENSE文件。