Joplin MCP Server
by jisung58
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 (copied from Joplin Desktop → Tools → Options → Web Clipper) | |
| MCP_TRANSPORT | No | Transport to use for the MCP server: 'stdio' (default), 'http', 'http-compat', 'sse', or 'streamable-http' | |
| JOPLIN_TIMEOUT | No | Request timeout in seconds | 30 |
| MCP_HTTP_COMPAT | No | Set to 1/true to enable the opt-in HTTP compatibility bundle (modern /mcp JSON-RPC plus legacy /sse and /messages endpoints) when using the http transport | |
| JOPLIN_TOOL_GET_NOTE | No | Toggle the get_note tool (true|false) | true |
| JOPLIN_TOOL_TAG_NOTE | No | Toggle the tag_note tool (true|false) | true |
| JOPLIN_TOOL_EDIT_NOTE | No | Toggle the edit_note tool (true|false) | true |
| JOPLIN_TOOL_GET_LINKS | No | Toggle the get_links tool (true|false) | true |
| JOPLIN_TOOL_LIST_TAGS | No | Toggle the list_tags tool (true|false) | true |
| JOPLIN_TOOL_CREATE_TAG | No | Toggle the create_tag tool (true|false) | true |
| JOPLIN_TOOL_DELETE_TAG | No | Toggle the delete_tag tool (true|false) | false |
| JOPLIN_TOOL_FIND_NOTES | No | Toggle the find_notes tool (true|false) | true |
| JOPLIN_TOOL_UNTAG_NOTE | No | Toggle the untag_note tool (true|false) | true |
| JOPLIN_TOOL_UPDATE_TAG | No | Toggle the update_tag tool (true|false) | false |
| JOPLIN_TOOL_CREATE_NOTE | No | Toggle the create_note tool (true|false) | true |
| JOPLIN_TOOL_DELETE_NOTE | No | Toggle the delete_note tool (true|false) | false |
| JOPLIN_TOOL_PING_JOPLIN | No | Toggle the ping_joplin tool (true|false) | true |
| JOPLIN_TOOL_UPDATE_NOTE | No | Toggle the update_note tool (true|false) | true |
| JOPLIN_TOOL_FIND_IN_NOTE | No | Toggle the find_in_note tool (true|false) | true |
| JOPLIN_NOTEBOOK_ALLOWLIST | No | Comma-separated list of notebook patterns to allow access to (e.g., 'Work,Projects/*,!Projects/Secret'). Not set means no restriction; set but empty denies every notebook | |
| JOPLIN_TOOL_GET_ALL_NOTES | No | Toggle the get_all_notes tool (true|false) | false |
| JOPLIN_TOOL_LIST_NOTEBOOKS | No | Toggle the list_notebooks tool (true|false) | true |
| JOPLIN_TOOL_CREATE_NOTEBOOK | No | Toggle the create_notebook tool (true|false) | true |
| JOPLIN_TOOL_DELETE_NOTEBOOK | No | Toggle the delete_notebook tool (true|false) | false |
| JOPLIN_TOOL_UPDATE_NOTEBOOK | No | Toggle the update_notebook tool (true|false) | false |
| JOPLIN_TOOL_GET_TAGS_BY_NOTE | No | Toggle the get_tags_by_note tool (true|false) | true |
| JOPLIN_TOOL_IMPORT_FROM_FILE | No | Toggle the import_from_file tool (true|false) | false |
| JOPLIN_TOOL_RESTORE_FROM_TRASH | No | Toggle the restore_from_trash tool (true|false) | true |
| JOPLIN_TOOL_FIND_NOTES_WITH_TAG | No | Toggle the find_notes_with_tag tool (true|false) | true |
| JOPLIN_TOOL_FIND_NOTES_IN_NOTEBOOK | No | Toggle the find_notes_in_notebook tool (true|false) | 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
ResponsivenessNo issues