Multi Note

PyPI version Python versions License

一个搜索框，搜你所有的笔记 — 无论笔记在飞书、Obsidian、Notion、语雀、OneNote 还是印象笔记。

你的 AI Agent（Claude Code / Cursor / Cline / Hermes）只需要一个 MCP 入口，就能搜索、读取、创建你在 6 个平台上的笔记。

pip install mcp-multi-note
note setup
# 配到 Agent → 完事

---

痛点

你同时在用多个笔记平台吗？

场景	现状
Agent 想查你飞书里的笔记	得装飞书 MCP Server
再查你 Obsidian 里的笔记	再装 Obsidian MCP Server
再查你 Notion 的数据库	还得装 Notion MCP
……每个平台一个工具	配置越来越多，入口越来越乱

mcp-multi-note 解决这个问题：装一个，管所有。

---

一句话

一个 MCP Server，飞书 / Obsidian / Notion / 语雀 / OneNote / 印象笔记全部接入。你的 Agent 们通过同一个入口搜索和读写所有笔记。

---

效果

Agent 可以这样跟你对话：

你：查一下我笔记里关于"竞品分析"的内容
Agent：→ 同时搜飞书 + Obsidian + Notion
       → 聚合结果返回给你

不用手动切平台、不用记多个工具的配置、不用在每个 Agent 里配好几遍。

---

支持的平台

平台	状态	配置难度	时间
Obsidian	✅ 可用	自动	0 分钟
语雀	✅ 可用	简单	2 分钟
Notion	✅ 可用	简单	2 分钟
飞书	✅ 可用	中等	10 分钟
OneNote	✅ 可用	中等	15 分钟
印象笔记	✅ 可用	需审批	5 天

未配置的不会出现在 Agent 工具列表中，互不干扰。

---

快速开始

# 1. 安装
pip install mcp-multi-note

# 2. 运行向导（交互式配置各平台）
note setup

# 3. 配置 MCP（任选一个 Agent）
# Claude Code / Cursor / Cline → 加到 MCP 配置：
# {
#   "mcp-multi-note": {
#     "command": "note",
#     "args": ["mcp"]
#   }
# }
# Hermes → hermes config set mcp_servers.mcp-multi-note '{"command":"note","args":["mcp"]}'

# 4. 开始用（CLI 或 Agent 对话）
note search 关键词

---

核心功能

功能	note search	Agent 调用
搜索所有笔记	✅ note search 关键词	✅ {platform}_search
搜指定平台	✅ --from obsidian	✅ 调对应 tool
按时间排序	✅ --sort date	—
限制数量	✅ --limit 10	—
读取全文	✅ note {platform} read	✅ {platform}_read
创建笔记	✅ note {platform} create	✅ {platform}_create

---

架构

AI Agent (Claude Code / Cursor / Cline / Hermes / ...)
    │
    ▼  MCP stdio (JSON-RPC)
┌──────────────────────┐
│   note mcp           │  ← 一个 MCP 入口
│   tools/list/call    │
└──────┬───────────────┘
       │
┌──────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ Obsidian  │ │ 飞书        │ │ OneNote     │  ← 各平台独立 adapter
│ (本地文件)  │ │ (API)      │ │ (Graph API) │
└───────────┘ └─────────────┘ └─────────────┘
         ...更多平台

设计原则：

• 一个入口 — 所有 Agent 共用，只配一次
• 可插拔 — 每个平台独立 adapter，互不影响
• 零噪音 — 没配置的平台自动隐藏，不污染 tool 列表

---

CLI 预览

# 配置向导
note setup

# 跨平台搜索
note search "API 设计"                    # 搜所有平台
note search "竞品分析" --from obsidian    # 仅 Obsidian
note search "roadmap" --from feishu,notion --sort -date --limit 10

# 单平台操作
note feishu search "关键词"
note onenote read "page-id"
note obsidian list_notebooks

# MCP 模式（给 Agent 用）
note mcp

---

MCP 配置（各 Agent）

Agent	配置文件	添加方式
Claude Code	~/.claude/settings.json	加到 mcpServers
Cursor	~/.cursor/mcp.json	加到 mcpServers
Cline	~/.cline/mcp_settings.json	加到 mcpServers
Hermes	~/.hermes/config.yaml	hermes config set mcp_servers...

配置内容：

{
  "mcp-multi-note": {
    "command": "note",
    "args": ["mcp"]
  }
}

---

谁适合用

• 多笔记平台用户 — 飞书写文档、Obsidian 记日记、Notion 做项目管理……一个 Agent 全管
• AI Agent 重度用户 — Claude Code / Cursor / Cline 用户，不想每个 Agent 配一遍笔记工具
• 笔记太多找不动的人 — note search 比手动翻快得多

---

开发

git clone https://github.com/Hermes-pm/mcp-multi-note.git
cd mcp-multi-note
pip install -e .

---

License

MIT

---

v0.4 最新： 搜索支持 --from / --sort / --limit，富内容（表格→Markdown、图片 URL 保留）。查看更新日志