Joplin MCP Server
by aLemoine567
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). Obtain from Joplin Desktop → Tools → Options → Web Clipper. | |
| MCP_TRANSPORT | No | Transport protocol for the MCP server. Options: stdio, sse, streamable-http. Default is stdio (or http in Docker). | stdio |
| JOPLIN_TIMEOUT | No | Request timeout in seconds. | 30 |
| MCP_HTTP_COMPAT | No | Set to 1 or true to enable HTTP compatibility bundle (modern + legacy SSE endpoints). | |
| JOPLIN_TOOL_GET_NOTE | No | Enable or disable the get_note tool. Set to true or false. | true |
| JOPLIN_TOOL_TAG_NOTE | No | Enable or disable the tag_note tool. Set to true or false. | true |
| JOPLIN_TOOL_EDIT_NOTE | No | Enable or disable the edit_note tool. Set to true or false. | true |
| JOPLIN_TOOL_GET_LINKS | No | Enable or disable the get_links tool. Set to true or false. | true |
| JOPLIN_TOOL_LIST_TAGS | No | Enable or disable the list_tags tool. Set to true or false. | true |
| JOPLIN_TOOL_CREATE_TAG | No | Enable or disable the create_tag tool. Set to true or false. | true |
| JOPLIN_TOOL_DELETE_TAG | No | Enable or disable the delete_tag tool. Set to true or false. | false |
| JOPLIN_TOOL_FIND_NOTES | No | Enable or disable the find_notes tool. Set to true or false. | true |
| JOPLIN_TOOL_UNTAG_NOTE | No | Enable or disable the untag_note tool. Set to true or false. | true |
| JOPLIN_TOOL_UPDATE_TAG | No | Enable or disable the update_tag tool. Set to true or false. | false |
| JOPLIN_TOOL_CREATE_NOTE | No | Enable or disable the create_note tool. Set to true or false. | true |
| JOPLIN_TOOL_DELETE_NOTE | No | Enable or disable the delete_note tool. Set to true or false. | false |
| JOPLIN_TOOL_PING_JOPLIN | No | Enable or disable the ping_joplin tool. Set to true or false. | true |
| JOPLIN_TOOL_UPDATE_NOTE | No | Enable or disable the update_note tool. Set to true or false. | true |
| JOPLIN_TOOL_FIND_IN_NOTE | No | Enable or disable the find_in_note tool. Set to true or false. | 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 | Enable or disable the get_all_notes tool. Set to true or false. | false |
| JOPLIN_TOOL_LIST_NOTEBOOKS | No | Enable or disable the list_notebooks tool. Set to true or false. | true |
| JOPLIN_TOOL_CREATE_NOTEBOOK | No | Enable or disable the create_notebook tool. Set to true or false. | true |
| JOPLIN_TOOL_DELETE_NOTEBOOK | No | Enable or disable the delete_notebook tool. Set to true or false. | false |
| JOPLIN_TOOL_UPDATE_NOTEBOOK | No | Enable or disable the update_notebook tool. Set to true or false. | false |
| JOPLIN_TOOL_GET_TAGS_BY_NOTE | No | Enable or disable the get_tags_by_note tool. Set to true or false. | true |
| JOPLIN_TOOL_IMPORT_FROM_FILE | No | Enable or disable the import_from_file tool. Set to true or false. | false |
| JOPLIN_TOOL_RESTORE_FROM_TRASH | No | Enable or disable the restore_from_trash tool. Set to true or false. | true |
| JOPLIN_TOOL_FIND_NOTES_WITH_TAG | No | Enable or disable the find_notes_with_tag tool. Set to true or false. | true |
| JOPLIN_TOOL_FIND_NOTES_IN_NOTEBOOK | No | Enable or disable the find_notes_in_notebook tool. Set to true or 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