Skip to content
MCP server

Joplin MCP Server

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.10.0
Listing updated
4 days ago

About Joplin MCP Server

Joplin MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add joplin-mcp --env JOPLIN_TOKEN='<JOPLIN_TOKEN>' -- uvx joplin-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "joplin-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Configuration

  • JOPLIN_TOKENWeb Clipper authentication token from a running Joplin instanceRequired
  • JOPLIN_URLOptional override for the Joplin Web Clipper base URL (default http://localhost:41184)

Pricing

Open source

Joplin MCP Server FAQ

Is Joplin MCP Server free?

Yes. Joplin MCP Server is open source, so you can use and self-host it for free.

How do I add Joplin MCP Server to Claude Code?

Run this command in your terminal: claude mcp add joplin-mcp --env JOPLIN_TOKEN='<JOPLIN_TOKEN>' -- uvx joplin-mcp