@belsar-ai/joplin-mcp
v0.3.10
Published
Model Context Protocol (MCP) server for Joplin note-taking app
Downloads
313
Readme
joplin-mcp
Model Context Protocol (MCP) server for the Joplin note-taking app.
Designed by belsar.ai to be easy to install & enjoyable to use.
Quick Start
- Open Joplin & navigate to tools > web clipper > enable web clipper service
- The Joplin app needs to remain running (minimized is fine)
- Pick the install command for your platform:
claude mcp add --transport stdio joplin -- npx -y @belsar-ai/joplin-mcpcodex mcp add joplin -- npx -y @belsar-ai/joplin-mcpgemini extensions install https://github.com/belsar-ai/joplin-mcp- That's it. Send a test request like "Find my notes about installing Fedora linux".
Uninstall
To uninstall:
claude mcp remove joplincodex mcp remove joplingemini extensions uninstall joplinExample Usage
Find my notes about installing Arch Linux.Did you find any outdated info in my Arch Installation note?Look for all notes whose last update time was before 2025. tag those as 'archived'.Show me all notes in my Work Projects notebook.Make a new note with a Mermaid diagram showing how a bill is passed on Capitol Hill.Available Operations
| Category | Operations | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Notebooks | List notebooksCreate notebookGet notebook notesUpdate notebookDelete notebookGet notebook by IDMove note to notebook | | Notes | List all notesSearch notesGet noteCreate noteUpdate noteAppend to notePrepend to noteDelete note | | Tags | Add tags to noteRemove tags from noteList tagsRename tagDelete tagGet tag by IDGet notes by tag | | Attachments | List all resourcesGet resource metadataGet note attachmentsGet resource notesDownload attachmentUpload attachmentUpdate resourceDelete resource | | Revisions | List all revisionsGet revision |
Troubleshooting
- Verify Joplin desktop app is running
- Confirm Web Clipper is enabled in Joplin settings
- Ensure Joplin is listening on port 41184 (default)
- If auto-discovery fails, set
JOPLIN_TOKENin your environment (add to.bashrcor shell config) - Go outside for a nice walk
