Joplin MCP Server

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

Local serverstdioPython

What is the Joplin MCP Server?

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

The short version

This MCP server provides 26 optimized tools for comprehensive Joplin integration:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Joplin MCP Server

{
  "mcpServers": {
    "joplin": {
      "command": "uvx",
      "args": ["joplin-mcp"],
      "env": {
        "JOPLIN_TOKEN": "your-value",
        "JOPLIN_NOTEBOOK_ALLOWLIST": "your-value",
        "JOPLIN_HOST": "your-value",
        "JOPLIN_PORT": "your-value",
        "JOPLIN_TIMEOUT": "your-value",
        "MCP_HTTP_COMPAT": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
JOPLIN_TOKENCredential the server authenticates with.Yes
JOPLIN_NOTEBOOK_ALLOWLISTConfiguration value read at startup.Optional
JOPLIN_HOSTEndpoint or connection string the server talks to.Optional
JOPLIN_PORTConfiguration value read at startup.Optional
JOPLIN_TIMEOUTConfiguration value read at startup.Optional
MCP_HTTP_COMPATConfiguration value read at startup.Optional

Example prompts to try

  • “Use Joplin to Build.”

Frequently asked questions

FastMCP server exposing Joplin notes, notebooks, tags, and imports. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.