Provides tools for managing Joplin notes, notebooks, tags, and to-dos, including creating, updating, deleting, searching, and organizing content within the Joplin desktop application.
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
This server cannot be installed