joplin-mcp

适用于Joplin笔记应用的模型上下文协议（MCP）服务器。

由belsar.ai设计，易于安装且使用愉快。

视频

https://www.youtube.com/watch?v=B3qJa7ycqNM&t=6s

快速开始

1. 打开Joplin并导航到工具 > 网页剪辑器 > 启用网页剪辑器服务
2. Joplin应用程序需要保持运行状态（最小化也可以）
3. 根据你的平台选择安装命令：

claude mcp add --transport stdio joplin -- npx -y @belsar-ai/joplin-mcp

codex mcp add joplin -- npx -y @belsar-ai/joplin-mcp

gemini extensions install https://github.com/belsar-ai/joplin-mcp

4. 完成。发送一个测试请求，例如“查找我关于安装Fedora Linux的笔记”。

卸载

要卸载：

claude mcp remove joplin

codex mcp remove joplin

gemini extensions uninstall joplin

示例用法

查找我关于安装Arch Linux的笔记。

你在我的Arch安装笔记中找到过时的信息了吗？

查找所有最后更新时间在2025年之前的笔记，并将它们标记为'已归档'。

显示我工作项目笔记本中的所有笔记。

创建一个新的带有Mermaid图表的笔记，展示法案如何在国会山通过。

可用操作

类别	操作
笔记本	列出笔记本<br>创建笔记本<br>获取笔记本笔记<br>更新笔记本<br>删除笔记本<br>通过ID获取笔记本<br>移动笔记到笔记本
笔记	列出所有笔记<br>搜索笔记<br>获取笔记<br>创建笔记<br>更新笔记<br>追加到笔记<br>插入到笔记<br>删除笔记
标签	将标签添加到笔记<br>从笔记中移除标签<br>列出标签<br>重命名标签<br>删除标签<br>通过ID获取标签<br>通过标签获取笔记
附件	列出所有资源<br>获取资源元数据<br>获取笔记附件<br>获取资源笔记<br>下载附件<br>上传附件<br>更新资源<br>删除资源
版本	列出所有版本<br>获取版本

故障排除

• 验证Joplin桌面应用程序是否正在运行
• 确认Joplin设置中已启用网页剪辑器
• 确保Joplin正在监听默认端口41184
• 如果自动发现失败，请在环境变量中设置JOPLIN_TOKEN（添加到.bashrc或shell配置文件中）
• 去外面散散步