Skip to main content
Glama
Hermes-pm

mcp-multi-note

by Hermes-pm

mcp-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 保留)。查看更新日志

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Hermes-pm/mcp-multi-note'

If you have feedback or need assistance with the MCP directory API, please join our Discord server