Provides tools for managing Joplin notes, notebooks, tags, and to-dos, including creating, updating, deleting, searching, and organizing content within the Joplin desktop application.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Joplin MCP ServerCreate a note called 'Meeting Notes' in my Work notebook"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Joplin MCP Server
MCP (Model Context Protocol) server for Joplin Notes integration, allowing AI assistants to manage your notes, notebooks, and tags.
Features
Notes: List, create, update, search, and delete notes
Notebooks: List and create notebooks (folders)
Tags: List tags and tag notes
Search: Full Joplin search syntax support
To-dos: Create and manage to-do items
Prerequisites
Joplin desktop app must be running
Web Clipper service must be enabled
Setup
1. Enable Web Clipper in Joplin
Open Joplin desktop
Go to Tools → Options → Web Clipper
Click Enable Web Clipper Service
Copy the Authorization token
2. Install Dependencies
3. Configure Claude Code
Add to your Claude Code MCP settings (~/.claude/mcp_settings.json):
Available Tools
Tool | Description |
| List all notebooks |
| Create a new notebook |
| List notes (filterable by notebook) |
| Get full note content |
| Create a new note |
| Update existing note |
| Delete a note |
| Search notes |
| List all tags |
| Add tag to note |
Usage Examples
Once configured, you can ask Claude:
"Show me my Joplin notebooks"
"List my recent notes"
"Create a note called 'Meeting Notes' in my Work notebook"
"Search for notes about 'project plan'"
"What notes are tagged with 'important'?"
Search Syntax
The joplin_search_notes tool supports Joplin's query syntax:
title:meeting- Search in titlebody:action items- Search in bodytag:work- Filter by tagnotebook:Projects- Filter by notebooktype:todo- Only to-dosiscompleted:0- Incomplete to-doscreated:20240101- Created after dateupdated:20240101- Updated after date
Combine: tag:work type:todo iscompleted:0 finds incomplete work todos.
Note
Joplin desktop must be running for the MCP server to work. The API connects to localhost:41184 (the Web Clipper service).
License
MIT