Joplin MCP Server
Joplin MCP Server opens your notes to an AI assistant: search, read, create, edit, delete and import Markdown files.
- 96 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The assistant reads, changes and deletes notes, and the token sits in `.env` as plain text.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/joplin-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The assistant reads, changes and deletes notes, and the token sits in `.env` as plain text.
This is third-party code. Review the repository files before installing.
What it does
The MCP server connects to Joplin Desktop through the Web Clipper Service and gives the assistant eight tools: `search_notes`, `get_note`, `list_notebooks`, `create_notebook`, `create_note`, `update_note`, `delete_note` and `import_markdown`. Notebooks can be nested and addressed by a path such as `Work/Projects`. Notes are written in Markdown and can be marked as todos. Deleting moves a note to the trash, and the `permanent` parameter erases it for good. Access uses the API token from Web Clipper settings, stored in a `.env` file as `JOPLIN_TOKEN`.
Who it is for. Joplin users who keep Markdown notes and want to search and extend them through an assistant.
Good fit when
- A notebook holds hundreds of notes and you need an answer from them without manual search
- Meeting minutes should be saved to the `Work/Projects` notebook with one command
- A ready Markdown file has to be loaded into Joplin as a new note
- A to-do list lives in notes and the assistant should mark tasks
Not a fit when
- The assistant must not be trusted with deletion: `delete_note` can erase notes permanently
- Joplin Desktop is not running: the server talks to the app through the local Web Clipper
- You need semantic retrieval over text: the README describes only full-text search
Example request
Find notes about release 2.0 in Joplin and create a note with open tasks in the `Work/Projects` notebook.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
JOPLIN_TOKENrequired, secret- API token from the Web Clipper settings in Joplin Desktop.
Limitations
Python 3.10 or newer, `uv` and a running Joplin Desktop with the Web Clipper Service enabled are required. The token is stored as plain text in `.env`. The assistant gets rights to create, change and delete notes, including permanent deletion. The README covers setup for Claude Desktop only, and example paths must be replaced with your own. The last commit dates from August 2026. Export your notes from Joplin before the first run.
How to disable. Remove the `joplin` block from `claude_desktop_config.json` and restart Claude Desktop. Turn off the Web Clipper Service in Joplin and delete the token from `.env`.
FAQ
Where do I get the token for Joplin MCP Server?
Open Joplin Desktop, then Tools, Options, Web Clipper, enable the service and copy the API token. Put it into `.env` as `JOPLIN_TOKEN`.
Does `delete_note` erase notes for good?
Not by default, the note goes to the trash. It is erased permanently only with the `permanent` parameter.
Can I load a Markdown file into Joplin?
Yes, the `import_markdown` tool takes `file_path` and creates a new note from the file, optionally in the `notebook_name` notebook.
Does the server work without Joplin running?
No, it calls the Web Clipper Service inside Joplin Desktop, so the app must be running.
How do I choose a notebook when creating a note?
Pass `notebook_name` with a title or a path such as `Work/Projects`, or `parent_id` with the notebook ID.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for the Joplin notes app: an assistant searches, creates, edits, tags and restores notes from the trash.
An MCP server for Apple Notes on Mac: the agent reads, searches, creates, edits and exports notes and manages folders and tags.
Simplenote MCP: Simplenote notes in an agent
simplenote-mcp
Automattic's official Simplenote MCP server: an agent reads, searches and optionally edits notes, with no sign-in on macOS
The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat
Obsidian Sync MCP: an Obsidian vault for agents
Obsidian Sync MCP
An MCP server that lets an agent read and edit Obsidian notes from a folder or via Self-hosted LiveSync, even with your laptop off
A Rust MCP server for a folder of Markdown notes: an agent searches and reads notes and sees backlinks, tags, tasks and version history
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Joplin MCP Server (this card) | no | API key | 96 | |
| mcp-obsidian | no | API key | 4,533 | works with an Obsidian vault; Joplin MCP Server connects to Joplin through the Web Clipper |
| mcp-logseq: MCP server for Logseq | no | API key | 351 | reaches a Logseq graph; this server manages Joplin notebooks and notes |
README in short
The Python server uses the Joplin API and MCP over stdio. For debugging, `MCP_LOG_LEVEL=debug mcp dev` opens MCP Inspector in a browser.