Joplin MCP Server

A self-contained MCP (Model Context Protocol) server for Joplin. Bundles the Joplin Terminal CLI as a dependency - no desktop app, no global installs, no external processes to manage. Coexists with Joplin Desktop via automatic port negotiation. Its 12 documented tools cover note, folder. It runs locally over stdio via the published package.

People who work with note and folder and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-13 · ★ 7 · #90 OF 290 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-09-30

MIT · TypeScript servers · how we verify → /methodology

01 · Install Joplin MCP Server

before you install - you'll need

Set JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT before connecting.

Claude Code

claude mcp add jordanburke-joplin-mcp-server -- npx -y joplin-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "jordanburke-joplin-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "joplin-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package joplin-mcp-server - unscoped; check the name against the project README before installing

registry namespace io.github.jordanburke is GitHub-verified and matches the repo owner

03 · What Joplin MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can retrieve the complete notebook hierarchy, search for notes by query string, read contents of a specific notebook, and read full content of a specific note.

Capability map

Tools grouped from the project's README - what Joplin MCP Server lets an agent do.

read & search

4 tools - e.g. Retrieve the complete notebook hierarchy; Search for notes by query string; Read contents of a specific notebook

list_notebooks · search_notes · read_notebook · read_multinote

Note

4 tools - e.g. Read full content of a specific note; Create a new note; Edit an existing note

read_note · create_note · edit_note · delete_note

Folder

3 tools - e.g. Create a new notebook; Edit an existing notebook; Delete a notebook (requires confirmation)

create_folder · edit_folder · delete_folder

Sync

1 tool - e.g. Trigger sync (auto-syncs every 5 min by default)

sync

Latest releases

v2.3.3 · 2026-08-31

v2.3.2 · 2026-08-30

v2.3.1 · 2026-08-30

04 · Who maintains Joplin MCP Server

joplin-mcp-server is maintained by jordanburke. We track 4 MCP servers from jordanburke - 4 actively maintained, 289 combined GitHub stars, oldest repo from May 2025. Full record: all servers from jordanburke.

05 · Facts

repository: github.com/jordanburke/joplin-mcp-server
category: browser automation - ranked #90 of 290 actively-maintained browser automation servers as of 2026-09-30.
release cadence: 7 releases in the last 90 days (latest 2026-08-31)
registry: io.github.jordanburke/joplin-mcp-server (active, first published 2026-08-31)
packages: npm:joplin-mcp-server

06 · Joplin MCP Server FAQ

Is Joplin MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-13 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can Joplin MCP Server do?

With this server connected, an agent can retrieve the complete notebook hierarchy, search for notes by query string, read contents of a specific notebook, and read full content of a specific note.

How do I install Joplin MCP Server?

Run `npx -y joplin-mcp-server`. The README documents 3 environment variables (JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT) to set first. Set JOPLIN_TOKEN, JOPLIN_HOST, JOPLIN_PORT before connecting. You can also paste the ready-made client config above.

Does Joplin MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Joplin MCP Server

Alternatives to Joplin MCP Server

Maintained browser automation servers if Joplin MCP Server isn't the fit.

Pairs well with

Servers that cover what Joplin MCP Server doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · Zahori · Slack MCP Server · Scrcpy MCP · DrissionPage MCP · Deepbom

More TypeScript MCP servers · Reddit MCP Server (jordanburke) · SSH Client MCP Server · Lore (jordanhindo) · Wc26 · see all