mcpbeat Sign in

Joplin MCP Server

local only

Joplin MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 293 installs a week from pypi. Last commit 12 Sep 2026.

FastMCP server exposing Joplin notes, notebooks, tags, and imports.

Installs per day peak 133 · avg 52 · -10% w/w
a month agotoday
293
Installs / week
pypi · joplin-mcp
174
Stars
2 open issues
12 Sep 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 5 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command bootstrap.py:48
    result = subprocess.run([str(python), str(Path(__file__).resolve()), *sys.argv[1:]])

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add joplin-mcp -e 'JOPLIN_TOKEN=<JOPLIN_TOKEN>' -- uvx joplin-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.joplin-mcp]
command = "uvx"
args = ["joplin-mcp"]
env = { JOPLIN_TOKEN = "<JOPLIN_TOKEN>" }
.cursor/mcp.json
{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "joplin-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Put your own value in place of <JOPLIN_TOKEN> (Web Clipper authentication token from a running Joplin instance). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: JOPLIN_URL (Optional override for the Joplin Web Clipper base URL (default http://localhost:41184)).

Alternatives to Joplin MCP Server

same job, measured the same way
Notion MCP
by shck-dev

Notion MCP server — search, export, and import pages as markdown

53 installs/wk local only
MCP Z3 Prover
by daedalus

MCP server exposing Z3 solver API

86 installs/wk local only
Buildkite MCP Server
by buildkite

MCP server exposing Buildkite API data (pipelines, builds, jobs, tests) to AI tooling and editors.

local only
MCP Number Theory
by daedalus

MCP server exposing number theory functions and factorization algorithms

95 installs/wk local only
Atimelogger MCP
by zaplitny

MCP server exposing the ATimeLogger REST API (activities, reports, types)

64 installs/wk local only
Curtis MCP
by jordannewell

Expose any folder of notes as an MCP server — list, read, search, and (opt-in) write files.

49 installs/wk local only
MCP Exa
by daedalus

MCP server exposing Exa websearch API

105 installs/wk local only
Colab-MCP (unofficial)
by amgallego8

Unofficial MCP server for Google Colab: runtimes, code, long jobs, files and notebooks.

178 installs/wk local only

Joplin MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Joplin MCP Server?
Joplin MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package joplin-mcp was installed 293 times last week.
How do I connect Joplin MCP Server?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls joplin-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use Joplin MCP Server?
The pypi package joplin-mcp was installed 293 times in the last week. Week over week that is -10%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Joplin MCP Server open source?
Yes — it is published under the MIT licence, written in Python, 174 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.