Joplin MCP Server
A FastMCP wrapper around Joplin's Python API that gives Claude and other AI assistants direct access to your local notes. You get 25 tools spanning CRUD operations on notes, notebooks, and tags, plus search, trash management, and file imports (Markdown, HTML, CSV, JEX). The installer script walks you through token setup and permission levels (read, write, update, delete) for Claude Desktop, Jan AI, or OllMCP with local Ollama models. The notebook allowlist feature is worth noting if you want to fence off certain notebooks from AI access using gitignore-style patterns. Useful when you want Claude to search your knowledge base, draft meeting notes, or organize tags without manually copying text back and forth.
- GitHub stars
- 174
- tools
- 26
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Sep 12, 2026
Tools
26 toolsPublic tool metadata for what this MCP can expose to an agent.
find_notesFull-text search across all notes (supports task filtering; `trash=True` with `query="*"` lists trashed notes)
Full-text search across all notes (supports task filtering; `trash=True` with `query="*"` lists trashed notes)
No parameter schema in public metadata yet.
find_notes_with_tagFind notes with specific tag (supports task filtering)
Find notes with specific tag (supports task filtering)
No parameter schema in public metadata yet.
find_notes_in_notebookFind notes in specific notebook (supports task filtering)
Find notes in specific notebook (supports task filtering)
No parameter schema in public metadata yet.
get_all_notesGet all notes, most recent first (disabled by default)
Get all notes, most recent first (disabled by default)
No parameter schema in public metadata yet.
get_noteGet specific note by ID
Get specific note by ID
No parameter schema in public metadata yet.
find_in_noteRegex search within a single note (paginated matches & context, multiline anchors on by default)
Regex search within a single note (paginated matches & context, multiline anchors on by default)
No parameter schema in public metadata yet.
get_linksExtract links to other notes from a note
Extract links to other notes from a note
No parameter schema in public metadata yet.
get_note_resourcesList a note's resources (images, PDFs, attachments) and read their OCR text
List a note's resources (images, PDFs, attachments) and read their OCR text
No parameter schema in public metadata yet.
create_noteCreate new notes
Create new notes
No parameter schema in public metadata yet.
update_noteModify existing notes (incl. moving between notebooks)
Modify existing notes (incl. moving between notebooks)
No parameter schema in public metadata yet.
edit_notePrecision edit note content (find/replace, append, prepend)
Precision edit note content (find/replace, append, prepend)
No parameter schema in public metadata yet.
delete_noteRemove notes
Remove notes
No parameter schema in public metadata yet.
list_notebooksBrowse all notebooks
Browse all notebooks
No parameter schema in public metadata yet.
create_notebookCreate new notebooks under an optional parent (by name or path), optionally with an emoji icon
Create new notebooks under an optional parent (by name or path), optionally with an emoji icon
No parameter schema in public metadata yet.
update_notebookRename, change emoji icon, or move a notebook under another parent (or to top-level with `parent_name="/"`)
Rename, change emoji icon, or move a notebook under another parent (or to top-level with `parent_name="/"`)
No parameter schema in public metadata yet.
delete_notebookRemove notebooks
Remove notebooks
No parameter schema in public metadata yet.
list_tagsView all available tags
View all available tags
No parameter schema in public metadata yet.
create_tagCreate new tags
Create new tags
No parameter schema in public metadata yet.
update_tagModify tag titles
Modify tag titles
No parameter schema in public metadata yet.
delete_tagRemove tags
Remove tags
No parameter schema in public metadata yet.
get_tags_by_noteList tags on specific note
List tags on specific note
No parameter schema in public metadata yet.
tag_noteAdd one or more tags to one or more notes (accepts lists)
Add one or more tags to one or more notes (accepts lists)
No parameter schema in public metadata yet.
untag_noteRemove one or more tags from one or more notes (accepts lists)
Remove one or more tags from one or more notes (accepts lists)
No parameter schema in public metadata yet.
restore_from_trashRestore a soft-deleted note or notebook (pass `item_type='note'` or `'notebook'`)
Restore a soft-deleted note or notebook (pass `item_type='note'` or `'notebook'`)
No parameter schema in public metadata yet.
import_from_fileImport files/directories (MD, HTML, CSV, TXT, JEX)
Import files/directories (MD, HTML, CSV, TXT, JEX)
No parameter schema in public metadata yet.
ping_joplinTest connectivity
Test connectivity
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
JOPLIN_TOKEN*secretWeb Clipper authentication token from a running Joplin instance
JOPLIN_URLOptional override for the Joplin Web Clipper base URL (default http://localhost:41184)
Readme
Joplin MCP Server
A FastMCP-based Model Context Protocol (MCP) server for Joplin note-taking application via its Python API joppy, enabling AI assistants to interact with your Joplin notes, notebooks, and tags through a standardized interface.
Table of Contents
- What You Can Do
- Quick Start
- Supported Clients
- Example Usage
- Tool Permissions
- Notebook Allowlist
- Advanced Configuration
- Docker
- Project Structure
- Testing
- Complete Tool Reference
- Changelog
What You Can Do
This MCP server provides 26 optimized tools for comprehensive Joplin integration:
Details
- Repository
- github.com/alondmnt/joplin-mcp
- Package
joplin-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active