NoteBridge MCP
Provides tools for interacting with Notion's API, enabling management of pages, databases, blocks, users, comments, and content search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NoteBridge MCPFind my meeting notes from yesterday across all platforms"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NoteBridge MCP
统一多平台笔记 MCP 服务器 - 一个项目管理飞书、Notion、语雀三大平台。
架构说明
NoteBridge MCP 采用单一服务器架构,将三个平台的工具整合到一个 MCP 服务器中:
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ NoteBridge MCP Server │
│ (73 个工具) │
├─────────────────────────────────────────────────────────────┤
│ 飞书 (55个工具) │ Notion (10个工具) │ 语雀 (8个工具) │
└─────────────────────────────────────────────────────────────┘优势:
✅ 单一项目:一个 package.json,一个入口文件
✅ 单一配置:一个 .mcp.json 搞定
✅ 统一管理:所有工具在同一个服务器中
✅ 完整功能:73 个工具覆盖三大平台
Related MCP server: mcp-multi-note
快速开始
1. 安装依赖
cd D:\notebridge-mcp
bun install2. 配置 Token
编辑 D:\notebridge-mcp\.mcp.json,替换以下 Token:
{
"mcpServers": {
"notebridge": {
"command": "C:/Users/Siat/.bun/bin/bun.exe",
"args": ["run", "D:/notebridge-mcp/src/index.ts"],
"env": {
"LARK_APP_ID": "your_lark_app_id",
"LARK_APP_SECRET": "your_lark_app_secret",
"NOTION_API_KEY": "your_notion_token",
"YUQUE_TOKEN": "your_yuque_token"
}
}
}
}3. 复制配置到 Claude
cp D:\notebridge-mcp\.mcp.json ~/.claude/mcp.json4. 重启 Claude Code
关闭并重新打开 Claude Code,即可使用全部 73 个工具。
API 权限清单
飞书 (Lark) 所需权限
在 飞书开放平台 中配置:
权限 | 说明 | 用途 |
| Wiki 读写 | 知识库操作 |
| 移动 Wiki 节点 | 节点移动 |
| 文档只读 | 读取文档 |
| 文档读写 | 创建/更新文档 |
| 创建文档 | 新建文档 |
| 云盘操作 | 文件管理 |
| 多维表格 | 表格操作 |
| 读取任务 | 待办事项 |
| 写入任务 | 创建待办 |
| 读取任务清单 | 清单管理 |
| 写入任务清单 | 创建清单 |
| 任务分组 | 分组管理 |
| 联系人 | 部门成员 |
| 用户信息 | 获取用户 |
| 用户邮箱 | 获取邮箱 |
| 离线访问 | Token 刷新 |
配置步骤:
登录 飞书开放平台
进入你的应用 → 权限管理
添加上述所有权限
版本管理 → 发布新版本
重新授权
Notion 所需权限
在 Notion Integrations 中配置:
权限 | 说明 | 用途 |
Read content | 读取内容 | 搜索、读取页面/数据库 |
Update content | 更新内容 | 更新页面/数据库 |
Insert content | 插入内容 | 创建页面/数据库 |
Read user information | 读取用户信息 | 获取用户信息 |
配置步骤:
点击 "New integration"
填写名称,选择工作区
在 Capabilities 中勾选上述权限
点击 "Submit"
复制 "Internal Integration Token"(以
ntn_开头)重要:在 Notion 中连接需要访问的页面
打开目标页面
点击右上角
···→ Connections选择你的 Integration
语雀 (Yuque) 所需权限
在 语雀 Token 设置 中配置:
权限 | 说明 | 用途 |
读取 | 读取知识库和文档 | 搜索、读取 |
写入 | 创建和更新文档 | 创建、更新、删除 |
配置步骤:
点击右上角头像 → 账户设置
左侧菜单 → Token
点击 "新建 Token"
填写名称,选择 "读写" 权限
点击 "确定"
立即复制 Token(只显示一次)
完整工具列表
飞书工具 (55个)
认证工具 (5个)
工具 | 说明 |
| 自动 OAuth 授权 |
| 手动提交授权码 |
| 获取当前用户信息 |
| 查询指定用户 |
| 列出部门成员 |
Wiki 工具 (10个)
工具 | 说明 |
| 列出所有 Wiki 空间 |
| 列出 Wiki 节点 |
| 读取 Wiki 内容 |
| 更新 Wiki 内容 |
| 在 Wiki 顶部插入 |
| 在 Wiki 底部追加 |
| 在指定位置插入 |
| 删除指定范围 |
| 创建新节点 |
| 移动节点 |
文档工具 (16个)
工具 | 说明 |
| 创建文档 |
| 读取文档 |
| 在文档顶部插入 |
| 在文档底部追加 |
| 更新文档 |
| 删除文档 |
| 移动文档 |
| 在指定位置插入 |
| 删除指定范围 |
| 移动块 |
| 搜索块 |
| 缩进/取消缩进 |
| 批量更新 |
| 列出云盘文件 |
| 列出最近文件 |
| 全局搜索 |
格式转换工具 (1个)
工具 | 说明 |
| Blocks 转 Markdown |
待办工具 (8个)
工具 | 说明 |
| 列出待办 |
| 创建待办 |
| 搜索待办 |
| 更新待办 |
| 添加负责人 |
| 移除负责人 |
| 完成任务 |
| 删除任务 |
任务清单工具 (7个)
工具 | 说明 |
| 列出清单 |
| 创建清单 |
| 获取清单详情 |
| 更新清单 |
| 删除清单 |
| 添加任务到清单 |
| 从清单移除任务 |
| 列出清单任务 |
子任务工具 (3个)
工具 | 说明 |
| 创建子任务 |
| 列出子任务 |
| 更新子任务 |
任务分组工具 (4个)
工具 | 说明 |
| 列出分组 |
| 列出分组任务 |
| 创建分组 |
| 删除分组 |
Notion 工具 (22个)
工具 | 说明 |
| 搜索页面和数据库 |
| 获取页面详情 |
| 创建页面 |
| 更新页面属性 |
| 获取数据库详情 |
| 查询数据库 |
| 创建数据库 |
| 更新数据库 |
| 获取块详情 |
| 获取子块 |
| 追加子块 |
| 更新块 |
| 删除块 |
| 获取用户详情 |
| 列出用户 |
| 列出评论 |
| 创建评论 |
| 获取页面属性 |
| 获取内容湖 |
| 创建数据源 |
| 查询数据源 |
| 移动页面 |
语雀工具 (8个)
工具 | 说明 |
| 列出知识库 |
| 获取知识库详情 |
| 列出文档 |
| 获取文档详情 |
| 创建文档 |
| 更新文档 |
| 删除文档 |
| 搜索内容 |
使用示例
跨平台搜索
帮我搜索所有平台上关于"项目进展"的内容Claude 会并行调用:
lark_search搜索飞书API-post-search搜索 Notionyuque_search搜索语雀
内容迁移
把我 Notion 上的"产品需求文档"复制到飞书知识库Claude 会:
API-retrieve-a-page读取 Notion 文档API-retrieve-block-children获取内容wiki_create_node在飞书创建页面wiki_append写入内容
统一待办
查看我在所有平台上的待办事项Claude 会:
todo_list获取飞书待办API-query-a-database查询 Notion 数据库(如果有待办数据库)
项目结构
D:\notebridge-mcp\
├── package.json # 统一依赖管理
├── tsconfig.json
├── README.md # 本文档
├── .mcp.json # MCP 配置文件
└── src/
├── index.ts # 入口文件
├── constants.ts # 常量配置(三个平台)
├── lifecycle.ts # 生命周期管理
├── services/
│ ├── lark-client.ts # 飞书 API 客户端
│ ├── notion-client.ts # Notion API 客户端
│ └── yuque-client.ts # 语雀 API 客户端
├── tools/
│ ├── auth.ts # 飞书认证工具 (5个)
│ ├── wiki.ts # 飞书 Wiki 工具 (10个)
│ ├── doc.ts # 飞书文档工具 (16个)
│ ├── todo.ts # 飞书待办工具 (24个)
│ ├── notion.ts # Notion 工具 (10个)
│ └── yuque.ts # 语雀工具 (8个)
├── schemas/
│ ├── common.ts
│ ├── auth.ts
│ ├── wiki.ts
│ ├── doc.ts
│ └── todo.ts
└── utils/
├── errors.ts
├── rate-limiter.ts
├── retry.ts
├── markdown.ts
├── oauth-callback.ts
└── response.ts常见问题
Q: 重启后工具没有出现?
A: 检查 ~/.claude/mcp.json 文件是否存在且格式正确。
Q: API 调用失败?
A: 检查 Token 是否有效,权限是否完整。参考上方的「API 权限清单」。
Q: 如何更新某个平台?
A: 进入对应目录执行 git pull 即可,各平台独立更新:
cd D:\lark-office-mcp && git pull
cd D:\notion-mcp-server && git pull
cd D:\yuque-mcp-server && git pullQ: 如何添加更多平台?
A: 参考现有项目结构,创建新的 MCP 服务器,然后在 .mcp.json 中添加配置。
更新日志
v1.0.0 (2026-06-10)
初始版本
单一项目整合飞书、Notion、语雀三大平台
73 个工具(飞书 55 + Notion 10 + 语雀 8)
统一的 API 客户端和错误处理
完整的权限清单和配置指南
相关项目
本项目在设计上参考了以下两个仓库:
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
MCP server aggregating hot-search boards from 8 Chinese platforms (Weibo, Zhihu, Bilibili, Douyin).
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceA unified MCP server that provides OAuth-enabled integrations for multiple services through a single deployment. Currently supports Slack with 47 tools, with plans to expand to Gmail, Google Calendar, Notion, and 100+ other integrations.6MIT- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to search, read, and create notes across six note-taking platforms (Feishu, Obsidian, Notion, Yuque, OneNote, Evernote) through a single unified interface.MIT
- AlicenseCqualityCmaintenanceMCP server with 23 tools for full Notion integration, enabling database, page, block, user, search, comment, template, and duplication operations through natural language.2311 npmMIT
- AlicenseBqualityDmaintenanceAn MCP server that exposes Feishu (Lark) APIs as standardized tools, enabling knowledge base, document, spreadsheet, and IM operations through any MCP client.3627 npmMIT