# 安装 io.github.jordanburke/joplin-mcp-server

- 类型: MCP 工具
- 说明: Search, read, create, edit and sync Joplin notes and notebooks via a headless Joplin sidecar.
- 仓库: https://github.com/jordanburke/joplin-mcp-server

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.jordanburke/joplin-mcp-server" MCP 服务：
执行：claude mcp add 'io-github-jordanburke-joplin-mcp-server' -- npx -y joplin-mcp-server
```

### Codex
```
请帮我安装 askskill 上的 "io.github.jordanburke/joplin-mcp-server" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-jordanburke-joplin-mcp-server]
command = "npx"
args = ["-y","joplin-mcp-server"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.jordanburke/joplin-mcp-server" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-jordanburke-joplin-mcp-server": { "command": "npx", "args": ["-y","joplin-mcp-server"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env JOPLIN_TOKEN=YOUR_VALUE --env JOPLIN_HOST=YOUR_VALUE --env JOPLIN_PORT=YOUR_VALUE --env JOPLIN_PROFILE=YOUR_VALUE --env JOPLIN_CLI=YOUR_VALUE --env JOPLIN_SYNC_TARGET=YOUR_VALUE --env JOPLIN_SYNC_PATH=YOUR_VALUE --env JOPLIN_SYNC_USERNAME=YOUR_VALUE --env JOPLIN_SYNC_PASSWORD=YOUR_VALUE --env JOPLIN_SYNC_REGION=YOUR_VALUE --env JOPLIN_SYNC_ENDPOINT=YOUR_VALUE --env JOPLIN_SYNC_FORCE_PATH_STYLE=YOUR_VALUE --env LOG_LEVEL=YOUR_VALUE --transport stdio io-github-jordanburke-joplin-mcp-server -- npx -y joplin-mcp-server
```
需要环境变量：JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT, JOPLIN_PROFILE, JOPLIN_CLI, JOPLIN_SYNC_TARGET, JOPLIN_SYNC_PATH, JOPLIN_SYNC_USERNAME, JOPLIN_SYNC_PASSWORD, JOPLIN_SYNC_REGION, JOPLIN_SYNC_ENDPOINT, JOPLIN_SYNC_FORCE_PATH_STYLE, LOG_LEVEL

### Codex
```bash
codex mcp add --env JOPLIN_TOKEN=YOUR_VALUE --env JOPLIN_HOST=YOUR_VALUE --env JOPLIN_PORT=YOUR_VALUE --env JOPLIN_PROFILE=YOUR_VALUE --env JOPLIN_CLI=YOUR_VALUE --env JOPLIN_SYNC_TARGET=YOUR_VALUE --env JOPLIN_SYNC_PATH=YOUR_VALUE --env JOPLIN_SYNC_USERNAME=YOUR_VALUE --env JOPLIN_SYNC_PASSWORD=YOUR_VALUE --env JOPLIN_SYNC_REGION=YOUR_VALUE --env JOPLIN_SYNC_ENDPOINT=YOUR_VALUE --env JOPLIN_SYNC_FORCE_PATH_STYLE=YOUR_VALUE --env LOG_LEVEL=YOUR_VALUE io-github-jordanburke-joplin-mcp-server -- npx -y joplin-mcp-server
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-jordanburke-joplin-mcp-server]
command = "npx"
args = ["-y","joplin-mcp-server"]

[mcp_servers.io-github-jordanburke-joplin-mcp-server.env]
JOPLIN_TOKEN = "YOUR_VALUE"
JOPLIN_HOST = "YOUR_VALUE"
JOPLIN_PORT = "YOUR_VALUE"
JOPLIN_PROFILE = "YOUR_VALUE"
JOPLIN_CLI = "YOUR_VALUE"
JOPLIN_SYNC_TARGET = "YOUR_VALUE"
JOPLIN_SYNC_PATH = "YOUR_VALUE"
JOPLIN_SYNC_USERNAME = "YOUR_VALUE"
JOPLIN_SYNC_PASSWORD = "YOUR_VALUE"
JOPLIN_SYNC_REGION = "YOUR_VALUE"
JOPLIN_SYNC_ENDPOINT = "YOUR_VALUE"
JOPLIN_SYNC_FORCE_PATH_STYLE = "YOUR_VALUE"
LOG_LEVEL = "YOUR_VALUE"
```
需要环境变量：JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT, JOPLIN_PROFILE, JOPLIN_CLI, JOPLIN_SYNC_TARGET, JOPLIN_SYNC_PATH, JOPLIN_SYNC_USERNAME, JOPLIN_SYNC_PASSWORD, JOPLIN_SYNC_REGION, JOPLIN_SYNC_ENDPOINT, JOPLIN_SYNC_FORCE_PATH_STYLE, LOG_LEVEL

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-jordanburke-joplin-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "joplin-mcp-server"
      ],
      "env": {
        "JOPLIN_TOKEN": "YOUR_VALUE",
        "JOPLIN_HOST": "YOUR_VALUE",
        "JOPLIN_PORT": "YOUR_VALUE",
        "JOPLIN_PROFILE": "YOUR_VALUE",
        "JOPLIN_CLI": "YOUR_VALUE",
        "JOPLIN_SYNC_TARGET": "YOUR_VALUE",
        "JOPLIN_SYNC_PATH": "YOUR_VALUE",
        "JOPLIN_SYNC_USERNAME": "YOUR_VALUE",
        "JOPLIN_SYNC_PASSWORD": "YOUR_VALUE",
        "JOPLIN_SYNC_REGION": "YOUR_VALUE",
        "JOPLIN_SYNC_ENDPOINT": "YOUR_VALUE",
        "JOPLIN_SYNC_FORCE_PATH_STYLE": "YOUR_VALUE",
        "LOG_LEVEL": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-jordanburke-joplin-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImpvcGxpbi1tY3Atc2VydmVyIl0sImVudiI6eyJKT1BMSU5fVE9LRU4iOiJZT1VSX1ZBTFVFIiwiSk9QTElOX0hPU1QiOiJZT1VSX1ZBTFVFIiwiSk9QTElOX1BPUlQiOiJZT1VSX1ZBTFVFIiwiSk9QTElOX1BST0ZJTEUiOiJZT1VSX1ZBTFVFIiwiSk9QTElOX0NMSSI6IllPVVJfVkFMVUUiLCJKT1BMSU5fU1lOQ19UQVJHRVQiOiJZT1VSX1ZBTFVFIiwiSk9QTElOX1NZTkNfUEFUSCI6IllPVVJfVkFMVUUiLCJKT1BMSU5fU1lOQ19VU0VSTkFNRSI6IllPVVJfVkFMVUUiLCJKT1BMSU5fU1lOQ19QQVNTV09SRCI6IllPVVJfVkFMVUUiLCJKT1BMSU5fU1lOQ19SRUdJT04iOiJZT1VSX1ZBTFVFIiwiSk9QTElOX1NZTkNfRU5EUE9JTlQiOiJZT1VSX1ZBTFVFIiwiSk9QTElOX1NZTkNfRk9SQ0VfUEFUSF9TVFlMRSI6IllPVVJfVkFMVUUiLCJMT0dfTEVWRUwiOiJZT1VSX1ZBTFVFIn19
需要环境变量：JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT, JOPLIN_PROFILE, JOPLIN_CLI, JOPLIN_SYNC_TARGET, JOPLIN_SYNC_PATH, JOPLIN_SYNC_USERNAME, JOPLIN_SYNC_PASSWORD, JOPLIN_SYNC_REGION, JOPLIN_SYNC_ENDPOINT, JOPLIN_SYNC_FORCE_PATH_STYLE, LOG_LEVEL