
Joplin MCP Server
by alondmntio.github.alondmnt/joplin-mcpv0.10.0
FastMCP server exposing Joplin notes, notebooks, tags, and imports.
context tax
queued
security
queued
cold start
queued
freshness
Active28d ago
Install Joplin MCP server
Install in Claude Code
claude mcp add joplin -e JOPLIN_TOKEN='<joplin-token>' -- uvx joplin-mcpInstall in Cursor
{
"mcpServers": {
"joplin": {
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<joplin-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"joplin": {
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<joplin-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"joplin": {
"type": "stdio",
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<joplin-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"joplin": {
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<joplin-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| JOPLIN_TOKEN | yes | yes | Web Clipper authentication token from a running Joplin instance |
| JOPLIN_URL | — | — | Optional override for the Joplin Web Clipper base URL (default http://localhost:41184) |
Freshness
Active — last maintenance signal 28d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-12 · 28d ago · GitHub
Latest release
2026-09-12 · 28d ago · GitHub · v0.10.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-12 · 28d ago · official registry · v0.10.0
FAQ
›How do I install the Joplin MCP server in Claude Code?
Run: claude mcp add joplin -e JOPLIN_TOKEN='<joplin-token>' -- uvx joplin-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Joplin require an API key?
Yes. It expects JOPLIN_TOKEN, of which 1 is a secret.
›Can I use Joplin as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Joplin in the official MCP registry?
Yes, as io.github.alondmnt/joplin-mcp.
Alternatives to Joplin
Other notes & knowledge MCP servers.