HelloWorld
登录
诺

诺记AI连接器

**Notion MCP Server** 是一个MCP服务器实现，它使AI助手能够与Notion的API进行交互。

note-takingdatabases

761 查看 · 2026-07-07 更新

简介

Notion MCP Server 是一个MCP服务器实现，它使AI助手能够与Notion的API进行交互。

简介

Notion MCP Server 是一个MCP服务器实现，它使AI助手能够与Notion的API进行交互。

Notion MCP 服务器

License TypeScript 模型上下文协议 smithery 徽章 NPM 下载量 Stars

Notion MCP 服务器 是一个实现了模型上下文协议 (MCP) 的服务器，它使 AI 助手能够与 Notion 的 API 进行交互。这个生产就绪的服务器提供了一整套工具和端点，通过自然语言交互来读取、创建和修改 Notion 内容。

🚧 积极开发中：现已支持数据库！已添加评论和用户管理工具。如果您觉得这个项目有用，请考虑给它一个星标 - 这有助于我知道这项工作对社区有价值，并激励进一步的开发。

📑 目录

🚀 开始使用 & 集成

设置过程

  1. 获取 Notion API 密钥

  2. 为您的页面启用集成

    • 选择一个现有的页面或在 Notion 中创建一个新的页面
    • 点击右上角的 "..." 菜单
    • 转到 "连接"
    • 从列表中找到并启用您的集成

    Notion 页面连接

  3. 选择您的集成方法

    • 根据您首选的 MCP 客户端，遵循以下一种集成选项

  4. 让您的 AI 助手与 Notion 交互

    • “创建一个包含今天任务的新页面”
    • “在我的会议笔记中更新内容”
    • “在我的会议笔记页面中添加项目符号”
    • “创建一个新的数据库以跟踪项目”
    • “向我的任务数据库添加新条目”
    • “在我的项目页面上添加评论”
    • “显示此文档中的所有评论”
    • “列出我工作区中的所有用户”
    • “获取关于特定用户的信息”

Cursor 集成

方法 1: 使用 mcp.json

  1. 在您的项目目录中创建或编辑 .cursor/mcp.json 文件：
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx",
      "args": ["-y", "notion-mcp-server"]
    }
  }
}
  1. 将 YOUR_KEY 和 YOUR_PAGE_ID 替换为您的实际 Notion API 密钥和页面 ID
  2. 重启 Cursor 以应用更改

方法 2：手动模式

  1. 打开 Cursor 并进入设置
  2. 导航到 "MCP" 或 "模型上下文协议" 部分
  3. 点击 "添加服务器" 或等效选项
  4. 在相应的字段中输入以下命令：
env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server
  1. 将 YOUR_KEY 和 YOUR_PAGE_ID 替换为您的实际 Notion API 密钥和页面 ID
  2. 保存设置，如有必要，请重启 Cursor

Claude 桌面集成

  1. 在配置目录中创建或编辑 mcp.json 文件：
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_KEY",
        "NOTION_PAGE_ID": "YOUR_PAGE_ID"
      }
    }
  }
}
  1. 将 YOUR_KEY 和 YOUR_PAGE_ID 替换为您的实际 Notion API 密钥和页面 ID
  2. 重启 Claude Desktop 以应用更改

🌟 功能

  • 📝 Notion 集成 - 与 Notion 数据库、页面和块交互
  • 🔌 通用 MCP 兼容性 - 适用于所有 MCP 客户端，包括 Cursor、Claude Desktop、Cline 和 Zed
  • 🔍 数据检索 - 从 Notion 页面、块和数据库获取信息
  • ✏️ 内容创建 - 创建和更新 Notion 页面和块
  • 📊 块管理 - 在 Notion 页面内追加、更新和删除块
  • 💾 数据库操作 - 创建、查询和更新数据库
  • 🔄 批量操作 - 在单个请求中执行多个操作
  • 🗑️ 归档与恢复 - 归档和恢复 Notion 页面
  • 🔎 搜索功能 - 按标题搜索 Notion 页面和数据库
  • 💬 评论管理 - 获取、创建和回复页面和讨论中的评论
  • 👥 用户管理 - 检索工作区用户和用户信息

📚 文档

可用工具

服务器提供了以下工具来与 Notion 互动：

页面操作

create_page

在 Notion 中使用指定内容创建新页面

update_page_properties

更新现有 Notion 页面的属性

archive_page

通过 ID 归档（移至回收站）Notion 页面

restore_page

通过 ID 恢复先前归档的 Notion 页面

search_pages

按标题搜索 Notion 中的页面和数据库

数据库操作

create_database

在 Notion 中使用指定属性创建新数据库

query_database

使用过滤器、排序和分页查询 Notion 中的数据库

update_database

更新现有数据库的属性、标题或描述

块操作

retrieve_block

通过 ID 从 Notion 中检索块

retrieve_block_children

从 Notion 中检索块的子块

append_block_children

向 Notion 中的父块追加子块

update_block

在 Notion 中更新块的内容

delete_block

在 Notion 中删除（移至回收站）块

批量操作

batch_append_block_children

在一个操作中向多个块追加子块

batch_update_blocks

在一个操作中更新多个块

batch_delete_blocks

删除多个块的单个操作

batch_mixed_operations

在一个请求中执行混合的追加、更新和删除操作

评论操作

get_comments

从页面或块中检索带有分页支持的评论

add_page_comment

向 Notion 页面添加新评论

add_discussion_comment

向现有的讨论线程添加评论

用户操作

get_list_users

检索工作区中所有用户的分页列表

get_user

通过 ID 获取特定用户的具体信息

get_bot_user

检索与 API 令牌关联的当前机器人用户

可用资源

服务器目前不公开任何资源，而是专注于基于工具的操作。

🛠 开发

  1. 克隆仓库

    git clone https://github.com/awkoy/notion-mcp-server.git
cd notion-mcp-server

  2. 安装依赖

    npm install

  3. 设置环境变量

    • 创建一个 .env 文件，内容如下： 
      NOTION_TOKEN=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

  4. 构建项目

    npm run build

  5. 运行检查器

    npm run inspector

🔧 技术细节

  • 使用 TypeScript 和 MCP SDK (版本 1.7.0+)
  • 使用官方 Notion API 客户端 (@notionhq/client v2.3.0+)
  • 遵循 Model Context Protocol 规范
  • 实现了对 Notion 页面、块和数据库的 CRUD 操作工具
  • 支持高效的批处理操作以优化性能
  • 使用 Zod 模式验证输入/输出

❓ 故障排除

  • 常见问题

    • 认证错误：确保您的 Notion 令牌具有正确的权限，并且已为您的页面/数据库启用了集成
    • 页面访问问题：确保您的集成已添加到您尝试访问的页面
    • 速率限制：Notion API 有速率限制 - 使用批处理操作来优化请求

  • 获取帮助

🤝 贡献

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

  1. 分叉仓库
  2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add some amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开一个 Pull Request

📄 许可证

此项目根据 MIT 许可证发布 - 详情请参见 LICENSE 文件。

服务配置

[{'mcpServers': {'notion-mcp-server': {'args': ['-y', 'notion-mcp-server'], 'command': 'npx', 'env': {'NOTION_PAGE_ID': 'YOUR_PAGE_ID', 'NOTION_TOKEN': 'YOUR_KEY'}}}}, {'mcpServers': {'notion-mcp-server': {'args': ['-y', 'notion-mcp-server'], 'command': 'env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx'}}}]

来源