Joplin MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JOPLIN_HOST | No | Joplin server hostname | localhost |
| JOPLIN_PORT | No | Joplin Web Clipper port | 41184 |
| JOPLIN_TOKEN | Yes | Joplin API authentication token (required) | |
| MCP_TRANSPORT | No | Transport protocol for the MCP server (http, sse, streamable-http, stdio) | http |
| JOPLIN_TIMEOUT | No | Request timeout in seconds | 30 |
| MCP_HTTP_COMPAT | No | Enable HTTP compatibility bundle (modern + legacy SSE endpoints) | false |
| JOPLIN_TOOL_GET_NOTE | No | Allow getting specific notes | true |
| JOPLIN_TOOL_TAG_NOTE | No | Allow adding tags to notes | true |
| JOPLIN_TOOL_EDIT_NOTE | No | Allow precision edits (find/replace, append, prepend) | true |
| JOPLIN_TOOL_GET_LINKS | No | Allow extracting links to other notes | true |
| JOPLIN_TOOL_LIST_TAGS | No | Allow listing all tags | true |
| JOPLIN_TOOL_CREATE_TAG | No | Allow creating new tags | true |
| JOPLIN_TOOL_DELETE_TAG | No | Allow deleting tags (disabled by default — destructive) | false |
| JOPLIN_TOOL_FIND_NOTES | No | Allow text search across notes (with task filtering) | true |
| JOPLIN_TOOL_UNTAG_NOTE | No | Allow removing tags from notes | true |
| JOPLIN_TOOL_UPDATE_TAG | No | Allow modifying tag titles | false |
| JOPLIN_TOOL_CREATE_NOTE | No | Allow creating new notes | true |
| JOPLIN_TOOL_DELETE_NOTE | No | Allow deleting notes (disabled by default — destructive) | false |
| JOPLIN_TOOL_PING_JOPLIN | No | Allow testing server connectivity | true |
| JOPLIN_TOOL_UPDATE_NOTE | No | Allow modifying existing notes | true |
| JOPLIN_TOOL_FIND_IN_NOTE | No | Allow regex search within a single note | true |
| JOPLIN_NOTEBOOK_ALLOWLIST | No | Comma-separated list of notebook patterns (e.g., Work,Projects/*,!Projects/Secret). Not set means no restriction; set but empty denies every notebook. | |
| JOPLIN_TOOL_GET_ALL_NOTES | No | Allow getting all notes (disabled by default - can fill context window) | false |
| JOPLIN_TOOL_LIST_NOTEBOOKS | No | Allow listing all notebooks | true |
| JOPLIN_TOOL_CREATE_NOTEBOOK | No | Allow creating new notebooks | true |
| JOPLIN_TOOL_DELETE_NOTEBOOK | No | Allow deleting notebooks (disabled by default — destructive) | false |
| JOPLIN_TOOL_UPDATE_NOTEBOOK | No | Allow modifying notebook titles and emoji icons | false |
| JOPLIN_TOOL_GET_TAGS_BY_NOTE | No | Allow getting tags for specific notes | true |
| JOPLIN_TOOL_IMPORT_FROM_FILE | No | Allow importing files/directories (MD, HTML, CSV, TXT, JEX) | false |
| JOPLIN_TOOL_RESTORE_FROM_TRASH | No | Allow restoring soft-deleted notes or notebooks | true |
| JOPLIN_TOOL_FIND_NOTES_WITH_TAG | No | Allow finding notes by tag (with task filtering) | true |
| JOPLIN_TOOL_FIND_NOTES_IN_NOTEBOOK | No | Allow finding notes by notebook (with task filtering) | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |