Notion MCP 服务器

一个用于 Claude AI 和 Notion 工作区之间无缝集成的 Model Context Protocol (MCP) 服务器实现，支持读写功能。

项目概述

该项目旨在构建一个 MCP 服务器，连接 Claude AI 和 Notion 工作区，允许 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. 通过点击任何页面/数据库右上角的“...”菜单并选择“添加连接”来共享你的 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 文档
• Model Context Protocol 规范
• 示例 MCP 服务器实现
• Claude 开发者文档

贡献

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

许可证

该项目在 MIT 许可证下发布，详细信息见 LICENSE 文件。