Joplin MCP 配置方法

前提条件

  1. Joplin 桌面端 已安装并运行
  2. 启用 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 下,不要嵌套

参考