How do I install the joplin mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `JOPLIN_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Joplin MCP Server

Go implementation of a Joplin MCP server, runnable through npx.

Local serverstdioGo

What is the Joplin MCP Server?

Go implementation of a Joplin MCP server, runnable through npx.

What the server does

Go implementation of a Joplin MCP server. It runs locally as a single binary over MCP stdio and talks to the Joplin Web Clipper REST API.

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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search_notes	get_note
create_note	update_note
delete_note	import_markdown

How to install the Joplin MCP Server

{
  "mcpServers": {
    "joplin-1": {
      "command": "npx",
      "args": ["-y", "joplin-mcp"],
      "env": {
        "JOPLIN_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
JOPLIN_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Joplin to search notes.”
“Use Joplin to create note.”
“Use Joplin to delete note.”

Frequently asked questions

Go implementation of a Joplin MCP server, runnable through npx. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Joplin MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

Pdf

A simple Model Context Protocol (MCP) server that provides PDF reading capabilities using pdfplumber.

Developer ToolsPython

Odata MCP Go

A Go implementation of the OData to Model Context Protocol (MCP) bridge, providing universal access to OData services through MCP tools.