Notion MCP Server

Notion MCP 服务

用于 Notion API 的 MCP 服务，可让 Claude 与 Notion 工作区交互。

工具

1. notion_append_block_children

   • 向父区块追加子区块。
   • 必填输入：
     • block_id（string）：父区块的 ID。
     • children（array）：要追加的区块对象数组。
   • 返回：追加区块的信息。

2. notion_retrieve_block

   • 获取特定区块的信息。
   • 必填输入：
     • block_id（string）：要获取的区块的 ID。
   • 返回：区块的详细信息。

3. notion_retrieve_block_children

   • 获取特定区块的子区块。
   • 必填输入：
     • block_id（string）：父区块的 ID。
   • 可选输入：
     • start_cursor（string）：用于获取下一页结果的游标。
     • page_size（number，默认值：100，最大值：100）：要获取的区块数量。
   • 返回：子区块列表。

4. notion_delete_block

   • 删除特定区块。
   • 必填输入：
     • block_id（string）：要删除的区块的 ID。
   • 返回：删除确认信息。

5. notion_retrieve_page

   • 获取特定页面的信息。
   • 必填输入：
     • page_id（string）：要获取的页面的 ID。
   • 返回：页面的详细信息。

6. notion_update_page_properties

   • 更新页面属性。
   • 必填输入：
     • page_id（string）：要更新的页面的 ID。
     • properties（object）：要更新的属性。
   • 返回：已更新页面的信息。

7. notion_create_database

   • 创建新数据库。
   • 必填输入：
     • parent（object）：数据库的父对象。
     • title（array）：以富文本数组形式提供的数据库标题。
     • properties（object）：数据库的属性架构。
   • 返回：已创建数据库的信息。

8. notion_query_database

   • 查询数据库。
   • 必填输入：
     • database_id（string）：要查询的数据库的 ID。
   • 可选输入：
     • filter（object）：筛选条件。
     • sorts（array）：排序条件。
     • start_cursor（string）：用于获取下一页结果的游标。
     • page_size（number，默认值：100，最大值：100）：要获取的结果数量。
   • 返回：查询结果列表。

9. notion_retrieve_database

   • 获取特定数据库的信息。
   • 必填输入：
     • database_id（string）：要获取的数据库的 ID。
   • 返回：数据库的详细信息。

10. notion_update_database

    • 更新数据库信息。
    • 必填输入：
      • database_id（string）：要更新的数据库的 ID。
    • 可选输入：
      • title（array）：数据库的新标题。
      • description（array）：数据库的新描述。
      • properties（object）：更新后的属性架构。
    • 返回：已更新数据库的信息。

11. notion_create_database_item

    • 在 Notion 数据库中创建新条目。
    • 必填输入：
      • database_id（string）：要向其中添加条目的数据库 ID。
      • properties（object）：新条目的属性。属性应与数据库架构匹配。
    • 返回：新建条目的信息。

设置

以下文章详细说明了上述步骤：

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

1. 创建 Notion 集成：

   • 访问 Notion 集成页面。
   • 点击“New Integration”。
   • 为集成命名并选择适当的权限（例如“Read content”“Update content”）。

2. 获取密钥：

   • 从集成中复制“Internal Integration Token”。
   • 此令牌将用于身份验证。

3. 将集成添加到工作区：

   • 在 Notion 中打开你希望集成访问的页面或数据库。
   • 点击右上角的导航按钮。
   • 点击“Connect to”按钮并选择你的集成。

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 文件。