Joplin MCP 配置方法
前提条件
- Joplin 桌面端 已安装并运行
- 启用 Web Clipper 服务:
- 打开 Joplin → 设置 (Preferences) → Web Clipper
- 勾选 "Enable Web Clipper service"(启用网页剪辑服务)
- 记下 Authorization Token
配置步骤
1. 编辑 Claude Code 配置文件
配置文件路径:~/.claude.json
在 mcpServers 中添加:
"joplin": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"joplin-mcp",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "你的Joplin授权Token"
}
}
2. 完整示例(mcpServers 部分)
"mcpServers": {
"fetch": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"joplin": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"joplin-mcp",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "d96d11e933314de505886b66b76277ff..."
}
},
"memory": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
3. 重启 Claude Code
配置完成后需要重启 Claude Code 才能加载新的 MCP 服务器工具。
4. 验证
运行以下命令确认连接成功:
claude mcp list
看到 joplin: uvx --from joplin-mcp joplin-mcp-server - ✓ Connected 即表示成功。
可用功能
配置成功后,Claude 可以对 Joplin 进行以下操作:
- 笔记:搜索、获取、创建、更新、删除
- 笔记本:列出、创建、更新、删除
- 标签:列出、创建、删除、给笔记打标签/取消标签
- 健康检查:
ping_joplin
注意事项
- 必须加
"type": "stdio",否则配置无法被识别 - Token 在 Joplin 的 Web Clipper 设置中可以找到
- 如果遇到
mcpServers.mcpServers警告,说明嵌套层级错误,joplin 应该直接放在mcpServers下,不要嵌套
参考
- PyPI: https://pypi.org/project/joplin-mcp/
- Joplin 官网: https://joplinapp.org/