Joplin MCP Server

Name: Joplin MCP Server
Author: alondmnt

by alondmntcommunityv0.7.1

The Joplin MCP Server is a FastMCP-based Model Context Protocol server that allows AI assistants to interact with Joplin notes, notebooks, and tags through a standardized interface using the Python API joppy.

From the registry: FastMCP server exposing Joplin notes, notebooks, tags, and imports.

GitHub Repository

Install & configure

Prerequisites

required
Enable Joplin Web Clipper
In Joplin Desktop: Tools → Options → Web Clipper → enable service and copy the authorization token.
https://joplinapp.org/
required
Install uv (for uvx)
Install uv toolchain to run via uvx.
```
$ pip install uv
```
https://github.com/astral-sh/uv

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `joplin-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Enable Joplin Web Clipper** — In Joplin Desktop: Tools → Options → Web Clipper → enable service and copy the authorization token. (https://joplinapp.org/)
- **Install uv (for uvx)** — Install uv toolchain to run via uvx. Run: `pip install uv` (https://github.com/astral-sh/uv)

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["--from","joplin-mcp","joplin-mcp-server"]
- required environment variables:
  - `JOPLIN_TOKEN`: Joplin Web Clipper authorization token. (example: `<your-joplin-token>`)

Note: An automated installer `joplin-mcp-install` is provided as well. Defaults assume Joplin is running locally on port 41184.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: An automated installer `joplin-mcp-install` is provided as well. Defaults assume Joplin is running locally on port 41184.

Tools (12)

find_notes

Search for notes based on various criteria.

create_note

Create new notes in Joplin.

update_note

Modify existing notes.

delete_note

Remove notes from Joplin.

list_notebooks

Retrieve a list of all notebooks.

create_notebook

Create new notebooks.

delete_notebook

Remove notebooks from Joplin.

list_tags

Retrieve a list of all tags.

create_tag

Create new tags.

delete_tag

Remove tags from Joplin.

import_from_file

Import notes from various file formats.

ping_joplin

Check the health of the Joplin server.

Environment variables

JOPLIN_TOKENrequiredYour Joplin API authentication token.

Packages

joplin-mcp

pypiv0.7.1transport: stdio

Details

Language: Python
License: MIT
Released: Mar 1, 2026
Last commit: Mar 1, 2026
Registry name: io.github.alondmnt/joplin-mcp

Related Servers

Context7

Up-to-date code docs for any prompt

52.4k

Pg Aiguide

Comprehensive PostgreSQL documentation and best practices, including ecosystem tools

1.7k

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

1.5k