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). Copy it from Joplin Desktop → Tools → Options → Web Clipper after enabling the Web Clipper service. | |
| MCP_TRANSPORT | No | Transport to use. One of 'stdio', 'http', 'sse', or 'streamable-http'. Defaults to HTTP in the Docker container. | |
| JOPLIN_TIMEOUT | No | Request timeout in seconds. | 30 |
| MCP_HTTP_COMPAT | No | Set to 1/true to enable the HTTP compatibility bundle (modern + legacy SSE endpoints) when using the http transport. | |
| 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 to allow access to (e.g., 'Work,Projects/*,!Projects/Secret'). Supports gitignore-style patterns: exact names, '*' wildcards, '**' recursive, and '!' negation. 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 | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessResponsive