joplin mcp server for Windsurf

io.github.jordanburke/joplin-mcp-server

Search, read, create, edit and sync Joplin notes and notebooks via a headless Joplin sidecar.

client:Windsurf transport:stdio runtime:npm

Install joplin mcp server in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "joplin-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "joplin-mcp-server"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>",
        "JOPLIN_HOST": "<JOPLIN_HOST>",
        "JOPLIN_PORT": "<JOPLIN_PORT>",
        "JOPLIN_PROFILE": "<JOPLIN_PROFILE>",
        "JOPLIN_CLI": "<JOPLIN_CLI>",
        "JOPLIN_SYNC_TARGET": "<JOPLIN_SYNC_TARGET>",
        "JOPLIN_SYNC_PATH": "<JOPLIN_SYNC_PATH>",
        "JOPLIN_SYNC_USERNAME": "<JOPLIN_SYNC_USERNAME>",
        "JOPLIN_SYNC_PASSWORD": "<JOPLIN_SYNC_PASSWORD>",
        "JOPLIN_SYNC_REGION": "<JOPLIN_SYNC_REGION>",
        "JOPLIN_SYNC_ENDPOINT": "<JOPLIN_SYNC_ENDPOINT>",
        "JOPLIN_SYNC_FORCE_PATH_STYLE": "<JOPLIN_SYNC_FORCE_PATH_STYLE>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

joplin mcp server in other clients

joplin mcp server MCP server