M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
J

Joplin MCP Server

社区
让 AI 通过 MCP 管理 Joplin 笔记。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
其他 第 106 / 230
Stars
★ 174 热门
传输方式
stdio（本地进程） · SSE · Streamable HTTP
运行环境
Python · Docker
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
工具数
26
55FMRS · C

一个面向 Joplin 的非官方 MCP 服务器，功能覆盖笔记、笔记本、标签、回收站和文件导入，并提供权限控制与笔记本允许列表。运行依赖 Joplin Web Clipper 和授权令牌；涉及写入、删除、导入或网络暴露时应谨慎配置。

最强项 · 文档质量 14/20 最弱项 · 维护活跃度 8/20

可靠性
9/20
安全与权限
11/20
维护活跃度
8/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
README 描述了 26 个工具、单元测试和端到端测试，并提供了 stdio 启动方式；但本次仅有 README 和 manifest，没有可核验的 CI 工作流、实际测试内容或错误处理实现证据。manifest 只声明 stdio，而 README 还描述多种 HTTP 传输；JOPLIN_URL 与 README 中的 JOPLIN_HOST/JOPLIN_PORT 也存在配置表述差异。因此只能确认正常路径合理，不能证明初始化、工具列表握手和边界错误均可靠，按静态规则扣分。
安全与权限 11/20
JOPLIN_TOKEN 被声明为 secret，默认使用本地 stdio；工具权限可分级，删除类操作默认关闭，并提供 notebook allowlist、内容暴露控制和访问过滤。这些证据支持基本的最小权限与数据边界设计。扣分原因是创建和更新操作若未显式配置通常启用，restore_from_trash 也默认启用，未见强制用户确认；HTTP/Docker 示例监听 0.0.0.0，网络认证与授权细节未说明；verify_ssl 默认 false，且个人笔记单项内容默认 full。没有证据达到安全满分，但未发现红线风险。
维护活跃度 8/20
项目未归档，声明 MIT 许可证，并有 0.9.0 manifest/package 版本和 6 个开放 issue，说明项目具有基本维护信号。扣分原因是源材料没有提交或发布频率、维护者响应、依赖更新、漏洞披露渠道或明确所有权信息，无法证明持续维护和安全响应能力。
文档质量 14/20
README 覆盖安装、Joplin token 获取、多个客户端、工具分类、权限开关、notebook allowlist、隐私设置、Docker、传输方式、配置变量、测试命令和故障排查，证据较完整。扣分原因是工具参数和返回限制并不系统，manifest 与 README 的传输及环境变量描述存在差异，未提供依赖维护、运行成本或可独立核验的实现证据。
安装易用性 13/20
提供 pip、uvx、源码 bootstrap、Claude Desktop、Claude Code、Jan、OllMCP、Docker 和手工配置示例，连接步骤总体清晰。扣分原因是必须运行 Joplin Web Clipper 并取得 token，部分路径依赖 uv、特定客户端配置或本地文件修改；HTTP/stdio 选项较多且 manifest 仅声明 stdio。由于没有真实 CI 或执行证据，按静态校准不超过 15 分。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • 希望通过 AI 管理个人 Joplin 知识库的用户。
  • 需要笔记、笔记本和标签搜索及组织能力的 MCP 客户端用户。
  • 需要按笔记本限制 AI 访问范围的用户。

不适合谁

  • 不使用 Joplin 或未启用 Web Clipper 的用户。
  • 需要在没有 Joplin API 令牌的情况下运行的用户。
  • 只需要只读访问且不希望配置写入、更新或导入权限的场景。

所需权限

  • 需要运行中的 Joplin Web Clipper 授权令牌，并通过 JOPLIN_TOKEN 提供。
  • 读取权限用于搜索、查看笔记本和标签及测试连接。
  • 写入、更新、删除和导入操作可通过配置或环境变量分别控制。
  • 删除笔记、笔记本和标签默认禁用；获取全部笔记和文件导入默认也禁用。
  • 可使用 notebook_allowlist 按笔记本路径限制读取和写入范围。

风险与副作用

  • 启用删除、更新或导入工具后，AI 可能修改或删除 Joplin 内容；删除操作默认关闭。
  • 未设置笔记本允许列表时，默认可访问所有笔记本。
  • 笔记搜索结果和单个笔记可能暴露内容；可通过 content_exposure 调整预览和全文显示。
  • 通过 HTTP 或 SSE 公开服务时，需要自行配置反向代理和 TLS；文档建议公开暴露时使用反向代理。
  • 令牌属于秘密凭据，不应公开或放入不受信任的配置中。

安装接入

准备工作

运行环境：Python · Docker

JOPLIN_TOKEN 必填密钥 Joplin 桌面端 Web Clipper 服务的授权令牌，在 Joplin 工具→选项→Web Clipper 中启用并复制，必填且为机密。
其他可选配置项（8 个）
JOPLIN_URL 可选 可选，覆盖 Joplin Web Clipper 的基础 URL，默认 http://localhost:41184。
JOPLIN_HOST 可选 可选，Joplin 服务器主机名，默认 localhost。
JOPLIN_PORT 可选 可选，Joplin Web Clipper 端口，默认 41184。
JOPLIN_TIMEOUT 可选 可选，请求超时时间（秒），默认 30。
JOPLIN_NOTEBOOK_ALLOWLIST 可选 可选，逗号分隔的笔记本模式列表（gitignore 风格），用于限制 AI 可访问的笔记本范围。
JOPLIN_TOOL_DELETE_NOTE 可选 可选，设为 true/false 控制是否启用 delete_note 工具，默认 false。
JOPLIN_TOOL_GET_ALL_NOTES 可选 可选，设为 true/false 控制是否启用 get_all_notes 工具，默认 false。
JOPLIN_TOOL_IMPORT_FROM_FILE 可选 可选，设为 true/false 控制是否启用 import_from_file 工具，默认 false。

在 Joplin Desktop 中打开“工具”→“选项”→“Web Clipper”，启用 Web Clipper 并复制授权令牌。安装 uv 后，使用提供的 Claude Desktop 配置，或运行 uvx --from joplin-mcp joplin-mcp-server。也可使用 pip 安装 joplin-mcp。必须设置 JOPLIN_TOKEN；可选设置 JOPLIN_URL 覆盖默认的 http://localhost:41184。配置后重启客户端。

claude_desktop_config.json 
{"mcpServers":{"joplin":{"command":"uvx","args":["--from","joplin-mcp","joplin-mcp-server"],"env":{"JOPLIN_TOKEN":"your_token_here"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "joplin": {
      "command": "uvx",
      "args": [
        "--from",
        "joplin-mcp",
        "joplin-mcp-server"
      ],
      "env": {
        "JOPLIN_TOKEN": "your_token_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add joplin -e JOPLIN_TOKEN=your_token_here -- uvx --from joplin-mcp joplin-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端连接后运行 ping_joplin 工具，或询问“列出我的所有笔记本”，若能返回笔记本列表即说明已成功连接到 Joplin。

常见排障

  1. 确认 Joplin Desktop 正在运行并已启用 Web Clipper。
  2. 检查 JOPLIN_TOKEN 是否为当前 Joplin 实例的授权令牌。
  3. 默认连接地址是 http://localhost:41184；如地址不同，设置 JOPLIN_URL 或相应主机和端口配置。
  4. 使用 uvx 时确认已安装 uv；使用 pip 安装时确认 joplin-mcp 已安装。
  5. 修改客户端配置后重启 Claude Desktop、Jan AI 或相应客户端。
  6. 端到端测试需要运行中的 Joplin 3.x 实例；连接不可达时测试会跳过。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 列出我的所有笔记本
  • 搜索关于 Python 编程的笔记
  • 为今天的站会创建一个会议笔记
  • 把我最近的 AI 笔记打上 important 标签

工具能力 26

find_notes 只读
搜索笔记，支持任务筛选和回收站查询。
find_notes_with_tag 只读
按标签查找笔记，支持任务筛选。
find_notes_in_notebook 只读
按笔记本查找笔记，支持任务筛选。
get_all_notes 只读
获取所有笔记，按最近更新排序；默认禁用。
get_note 只读
按 ID 获取指定笔记。
find_in_note 只读
在单个笔记中执行正则表达式搜索，并返回分页匹配和上下文。
get_links 只读
提取笔记中指向其他笔记的链接。
get_note_resources 只读
列出笔记资源，并读取图像和 PDF 的 OCR 文本。
展开其余 18 个工具
create_note 写入
创建笔记。
update_note 写入
修改笔记，包括移动笔记所属笔记本。
edit_note 写入
通过查找替换、追加或前置内容精确编辑笔记。
delete_note 破坏性
删除笔记。
list_notebooks 只读
列出可访问的笔记本。
create_notebook 写入
创建笔记本，可指定父笔记本和表情符号图标。
update_notebook 写入
重命名、修改图标或移动笔记本。
delete_notebook 破坏性
删除笔记本。
list_tags 只读
列出标签。
create_tag 写入
创建标签。
update_tag 写入
修改标签标题。
delete_tag 破坏性
删除标签。
get_tags_by_note 只读
获取指定笔记的标签。
tag_note 写入
为一个或多个笔记添加一个或多个标签。
untag_note 写入
从一个或多个笔记移除一个或多个标签。
restore_from_trash 写入
恢复软删除的笔记或笔记本。
import_from_file 写入
导入 Markdown、HTML、CSV、TXT、JEX 文件或目录。
ping_joplin 只读
测试与 Joplin 的连接。

使用场景

搜索和阅读 Joplin 笔记。
创建会议记录或其他新笔记。
整理笔记本和标签。
恢复回收站中的笔记或笔记本。
导入 Markdown、HTML、CSV、TXT 或 JEX 内容。

支持客户端

Claude Desktop
Jan AI
OllMCP

依据项目文档列出，未经本站实测。

详细介绍

Joplin MCP Server 是一个基于 FastMCP 的服务器，通过 Joplin Web Clipper API 和 Python 库 joppy，让兼容 MCP 的 AI 助手访问和管理 Joplin 笔记、笔记本与标签。它提供搜索、读取、创建、编辑、组织、恢复和文件导入功能。

同类可选方案

BioMCP 75 · B

统一的命令行语法，接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →
与其他 MCP 横向对比

源版本 b84c3131e64c 数据同步于 2026-10-19 查看 FMRS 评分方法