Notion MCP Server

Notion MCP 服务

这是一个 MCP（模型上下文协议）服务实现，可在 Claude AI 与 Notion 工作区之间无缝集成，并支持读取和写入。

项目概述

本项目旨在构建一个将 Claude AI 连接到 Notion 工作区的 MCP 服务，使 Claude 能够：

• 读取 Notion 数据库和页面中的内容
• 更新现有内容
• 搜索 Notion 工作区
• 查询和筛选数据库条目
• 获取详细的页面内容和数据库架构

前提条件

• Node.js（v16+）
• Notion API 密钥
• Claude Desktop

入门

1. 设置 Notion API 访问权限

1. 在 https://www.notion.so/my-integrations 创建 Notion 集成
2. 为集成命名（例如“Claude MCP Integration”）
3. 将集成类型设为“Internal”
4. 复制 API 密钥
5. 点击任意页面或数据库右上角的“...”菜单，选择“Add connections”，将 Notion 页面和数据库共享给该集成

2. 安装依赖项

npm install

3. 配置环境变量

在项目根目录中创建一个 .env 文件，并填入 Notion API 密钥：

NOTION_API_KEY=your_api_key_here

只有在开发此服务时才需要执行此步骤。

4. 构建

构建服务，以便 Claude 使用。

npm run build

如果你正在开发此服务，可以运行 npm run dev 或 npm run inspect。

5. 添加到 Claude Desktop 配置

打开 claude_desktop_config.json（前往 Settings > Developer 并点击 Edit Config），然后添加以下内容：

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}

6. 重启 Claude

重启 Claude 即可开始使用！

可用功能

此 MCP 服务提供以下工具：

• search_notion：使用查询字符串搜索 Notion 工作区
• get_notion_page：获取指定 Notion 页面的详细内容
• get_notion_database：获取 Notion 数据库的元数据和架构
• query_notion_database：搜索和筛选 Notion 数据库中的条目，并支持复杂查询

资源与参考资料

• Notion 官方 API 文档
• 模型上下文协议规范
• MCP 服务实现示例
• Claude 开发者文档

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。