joplin-mcp
连接AI助手与Joplin笔记的MCP服务器，实现智能笔记管理。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：joplin-mcp。 它的用途是：连接AI助手与Joplin笔记的MCP服务器，实现智能笔记管理。 完整的 Skill 内容见：https://321skill.com/skills/joplin-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查找上个月所有关于‘项目复盘’的笔记，并总结成一份会议摘要。”，它会调用`find_notes`进行搜索，读取相关笔记内容，并为你生成一份结构清晰的摘要。或者
对AI说：“将我刚口述的灵感保存到‘创意收集’笔记本里。”，它会调用`create_note`工具，自动创建并格式化一条新笔记。
介绍
Joplin MCP Server 解决了AI助手无法直接访问和操作本地Joplin笔记数据的问题。它通过标准化的Model Context Protocol (MCP)，为AI助手提供了读写笔记、管理笔记本和标签等26个工具，让AI能够成为你个人知识库的智能协作者。
使用前，你需要在Joplin桌面版中启用Web Clipper服务并获取API令牌。随后，可以通过简单的安装命令（如uvx --from joplin-mcp joplin-mcp-install）将其一键配置到Claude Desktop、Claude Code或Jan AI等支持MCP的客户端中，配置过程会自动完成令牌设置和权限管理。
这个Skill非常适合依赖Joplin构建知识体系，并希望借助AI提升信息整理、内容创作和知识检索效率的用户，例如内容创作者、学术研究者、高校学生和需要管理大量项目文档的项目经理。
请注意，使用前务必确保Joplin桌面版正在运行且Web Clipper服务已开启。为了数据安全，建议初次使用时仔细配置工具权限（如禁用删除功能），并可以考虑使用“笔记本白名单”功能来限制AI可访问的笔记本范围。
核心特点
与同类笔记集成工具相比，它基于FastMCP构建，提供了多达26个高度优化的专用工具，覆盖了从笔记CRUD、资源OCR读取、到标签管理和文件导入等全场景操作，功能最为全面。同时，它针对Claude Code等客户端提供了智能编排插件，能自动选择合适的工具（如区分编辑与更新），提升交互体验。
注意事项
不适合仅使用Joplin移动端或未开启Web Clipper服务的用户，也无法直接操作Joplin的加密笔记内容。
常见问题
如何获取Joplin的API令牌？
在Joplin桌面版中，依次点击“工具”->“选项”->“Web Clipper”，启用服务后即可复制令牌。
支持哪些AI客户端？
支持所有MCP兼容的客户端，如Claude Desktop、Claude Code、Jan AI、Cursor等，官方提供了前两者的详细配置指南。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/joplin-mcp/raw/index.md 读取 joplin-mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/joplin-mcp/raw/index.md（查看排版版本）