joplin-mcp-server
Rank #5,902io.github.jordanburke/joplin-mcp-server
Search, read, create, edit and sync Joplin notes and notebooks via a headless Joplin sidecar.
joplin-mcp-server is a Model Context Protocol (MCP) server published by jordanburke. It ranks #5,902 of 115,460 servers tracked on MCP Toplist, and its repository has 6 GitHub stars. joplin-mcp-server is listed across 3 registries — Official MCP, Glama and PulseMCP, with 1 tracked version. It was first listed on Jun 8, 2025 and most recently updated on Aug 31, 2026.
Ranks ahead of 109,558 of 115,460 servers on MCP Toplist.
Use joplin-mcp-server
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add joplin-mcp-server -e "JOPLIN_TOKEN=<your JOPLIN_TOKEN>" -e "JOPLIN_HOST=<your JOPLIN_HOST>" -e "JOPLIN_PORT=<your JOPLIN_PORT>" -e "JOPLIN_PROFILE=<your JOPLIN_PROFILE>" -e "JOPLIN_CLI=<your JOPLIN_CLI>" -e "JOPLIN_SYNC_TARGET=<your JOPLIN_SYNC_TARGET>" -e "JOPLIN_SYNC_PATH=<your JOPLIN_SYNC_PATH>" -e "JOPLIN_SYNC_USERNAME=<your JOPLIN_SYNC_USERNAME>" -e "JOPLIN_SYNC_PASSWORD=<your JOPLIN_SYNC_PASSWORD>" -e "JOPLIN_SYNC_REGION=<your JOPLIN_SYNC_REGION>" -e "JOPLIN_SYNC_ENDPOINT=<your JOPLIN_SYNC_ENDPOINT>" -e "JOPLIN_SYNC_FORCE_PATH_STYLE=<your JOPLIN_SYNC_FORCE_PATH_STYLE>" -e "LOG_LEVEL=<your LOG_LEVEL>" -- npx -y joplin-mcp-serverReplace each placeholder with your own value before saving.
[mcp_servers.joplin-mcp-server]
command = "npx"
args = ["-y", "joplin-mcp-server"]
[mcp_servers.joplin-mcp-server.env]
JOPLIN_TOKEN = "<your JOPLIN_TOKEN>"
JOPLIN_HOST = "<your JOPLIN_HOST>"
JOPLIN_PORT = "<your JOPLIN_PORT>"
JOPLIN_PROFILE = "<your JOPLIN_PROFILE>"
JOPLIN_CLI = "<your JOPLIN_CLI>"
JOPLIN_SYNC_TARGET = "<your JOPLIN_SYNC_TARGET>"
JOPLIN_SYNC_PATH = "<your JOPLIN_SYNC_PATH>"
JOPLIN_SYNC_USERNAME = "<your JOPLIN_SYNC_USERNAME>"
JOPLIN_SYNC_PASSWORD = "<your JOPLIN_SYNC_PASSWORD>"
JOPLIN_SYNC_REGION = "<your JOPLIN_SYNC_REGION>"
JOPLIN_SYNC_ENDPOINT = "<your JOPLIN_SYNC_ENDPOINT>"
JOPLIN_SYNC_FORCE_PATH_STYLE = "<your JOPLIN_SYNC_FORCE_PATH_STYLE>"
LOG_LEVEL = "<your LOG_LEVEL>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"joplin-mcp-server": {
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<your JOPLIN_TOKEN>",
"JOPLIN_HOST": "<your JOPLIN_HOST>",
"JOPLIN_PORT": "<your JOPLIN_PORT>",
"JOPLIN_PROFILE": "<your JOPLIN_PROFILE>",
"JOPLIN_CLI": "<your JOPLIN_CLI>",
"JOPLIN_SYNC_TARGET": "<your JOPLIN_SYNC_TARGET>",
"JOPLIN_SYNC_PATH": "<your JOPLIN_SYNC_PATH>",
"JOPLIN_SYNC_USERNAME": "<your JOPLIN_SYNC_USERNAME>",
"JOPLIN_SYNC_PASSWORD": "<your JOPLIN_SYNC_PASSWORD>",
"JOPLIN_SYNC_REGION": "<your JOPLIN_SYNC_REGION>",
"JOPLIN_SYNC_ENDPOINT": "<your JOPLIN_SYNC_ENDPOINT>",
"JOPLIN_SYNC_FORCE_PATH_STYLE": "<your JOPLIN_SYNC_FORCE_PATH_STYLE>",
"LOG_LEVEL": "<your LOG_LEVEL>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"joplin-mcp-server": {
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<your JOPLIN_TOKEN>",
"JOPLIN_HOST": "<your JOPLIN_HOST>",
"JOPLIN_PORT": "<your JOPLIN_PORT>",
"JOPLIN_PROFILE": "<your JOPLIN_PROFILE>",
"JOPLIN_CLI": "<your JOPLIN_CLI>",
"JOPLIN_SYNC_TARGET": "<your JOPLIN_SYNC_TARGET>",
"JOPLIN_SYNC_PATH": "<your JOPLIN_SYNC_PATH>",
"JOPLIN_SYNC_USERNAME": "<your JOPLIN_SYNC_USERNAME>",
"JOPLIN_SYNC_PASSWORD": "<your JOPLIN_SYNC_PASSWORD>",
"JOPLIN_SYNC_REGION": "<your JOPLIN_SYNC_REGION>",
"JOPLIN_SYNC_ENDPOINT": "<your JOPLIN_SYNC_ENDPOINT>",
"JOPLIN_SYNC_FORCE_PATH_STYLE": "<your JOPLIN_SYNC_FORCE_PATH_STYLE>",
"LOG_LEVEL": "<your LOG_LEVEL>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"joplin-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<your JOPLIN_TOKEN>",
"JOPLIN_HOST": "<your JOPLIN_HOST>",
"JOPLIN_PORT": "<your JOPLIN_PORT>",
"JOPLIN_PROFILE": "<your JOPLIN_PROFILE>",
"JOPLIN_CLI": "<your JOPLIN_CLI>",
"JOPLIN_SYNC_TARGET": "<your JOPLIN_SYNC_TARGET>",
"JOPLIN_SYNC_PATH": "<your JOPLIN_SYNC_PATH>",
"JOPLIN_SYNC_USERNAME": "<your JOPLIN_SYNC_USERNAME>",
"JOPLIN_SYNC_PASSWORD": "<your JOPLIN_SYNC_PASSWORD>",
"JOPLIN_SYNC_REGION": "<your JOPLIN_SYNC_REGION>",
"JOPLIN_SYNC_ENDPOINT": "<your JOPLIN_SYNC_ENDPOINT>",
"JOPLIN_SYNC_FORCE_PATH_STYLE": "<your JOPLIN_SYNC_FORCE_PATH_STYLE>",
"LOG_LEVEL": "<your LOG_LEVEL>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"joplin-mcp-server": {
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<your JOPLIN_TOKEN>",
"JOPLIN_HOST": "<your JOPLIN_HOST>",
"JOPLIN_PORT": "<your JOPLIN_PORT>",
"JOPLIN_PROFILE": "<your JOPLIN_PROFILE>",
"JOPLIN_CLI": "<your JOPLIN_CLI>",
"JOPLIN_SYNC_TARGET": "<your JOPLIN_SYNC_TARGET>",
"JOPLIN_SYNC_PATH": "<your JOPLIN_SYNC_PATH>",
"JOPLIN_SYNC_USERNAME": "<your JOPLIN_SYNC_USERNAME>",
"JOPLIN_SYNC_PASSWORD": "<your JOPLIN_SYNC_PASSWORD>",
"JOPLIN_SYNC_REGION": "<your JOPLIN_SYNC_REGION>",
"JOPLIN_SYNC_ENDPOINT": "<your JOPLIN_SYNC_ENDPOINT>",
"JOPLIN_SYNC_FORCE_PATH_STYLE": "<your JOPLIN_SYNC_FORCE_PATH_STYLE>",
"LOG_LEVEL": "<your LOG_LEVEL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"joplin-mcp-server": {
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<your JOPLIN_TOKEN>",
"JOPLIN_HOST": "<your JOPLIN_HOST>",
"JOPLIN_PORT": "<your JOPLIN_PORT>",
"JOPLIN_PROFILE": "<your JOPLIN_PROFILE>",
"JOPLIN_CLI": "<your JOPLIN_CLI>",
"JOPLIN_SYNC_TARGET": "<your JOPLIN_SYNC_TARGET>",
"JOPLIN_SYNC_PATH": "<your JOPLIN_SYNC_PATH>",
"JOPLIN_SYNC_USERNAME": "<your JOPLIN_SYNC_USERNAME>",
"JOPLIN_SYNC_PASSWORD": "<your JOPLIN_SYNC_PASSWORD>",
"JOPLIN_SYNC_REGION": "<your JOPLIN_SYNC_REGION>",
"JOPLIN_SYNC_ENDPOINT": "<your JOPLIN_SYNC_ENDPOINT>",
"JOPLIN_SYNC_FORCE_PATH_STYLE": "<your JOPLIN_SYNC_FORCE_PATH_STYLE>",
"LOG_LEVEL": "<your LOG_LEVEL>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.jordanburke%2Fjoplin-mcp-server)<a href="https://mcptoplist.com/server/io.github.jordanburke%2Fjoplin-mcp-server"><img src="https://mcptoplist.com/badge/io.github.jordanburke%2Fjoplin-mcp-server.svg" alt="MCP Toplist: Top 10% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries (1 delisted)
jordanburke
Other servers by jordanburke
- Reddit MCP Server#985 · 9 vers
- ssh-client-mcp-server#11,437 · 2 vers
- temporal-mcp-server#12,444 · 3 vers
- Microsoft To Do MCP#12,774
- DuckPond MCP Server#15,020 · 6 vers
- oura-ring-mcp-server#22,475 · 1 ver
- KuzuDB Server#27,347
- dakboard-mcp-server#99,835
Available versions (1)
| Version | Published |
|---|---|
| 2.3.3 | Aug 31, 2026 |
Frequently asked questions
- Who maintains joplin-mcp-server?
- joplin-mcp-server is maintained by jordanburke, which publishes 9 MCP servers (22 total versions) tracked on MCP Toplist.
- Is joplin-mcp-server listed on the Official MCP Registry?
- Yes — joplin-mcp-server is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does joplin-mcp-server have?
- MCP Toplist tracks 1 version of joplin-mcp-server, most recently published on Aug 31, 2026.
- Where can I find the source code for joplin-mcp-server?
- The source code for joplin-mcp-server is hosted at github.com/jordanburke/joplin-mcp-server.