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 mode for the server. For Docker, default is HTTP. For direct run, default is STDIO. Options: stdio, http, sse, streamable-http, http-compat. | |
| JOPLIN_TIMEOUT | No | Request timeout in seconds. | 30 |
| MCP_HTTP_COMPAT | No | Set to 1/true to enable HTTP compatibility bundle (modern + legacy SSE endpoints). | |
| JOPLIN_TOOL_GET_NOTE | No | Enable or disable the get_note tool. | true |
| JOPLIN_TOOL_TAG_NOTE | No | Enable or disable the tag_note tool. | true |
| JOPLIN_TOOL_EDIT_NOTE | No | Enable or disable the edit_note tool. | true |
| JOPLIN_TOOL_GET_LINKS | No | Enable or disable the get_links tool. | true |
| JOPLIN_TOOL_LIST_TAGS | No | Enable or disable the list_tags tool. | true |
| JOPLIN_TOOL_CREATE_TAG | No | Enable or disable the create_tag tool. | true |
| JOPLIN_TOOL_DELETE_TAG | No | Enable or disable the delete_tag tool. | false |
| JOPLIN_TOOL_FIND_NOTES | No | Enable or disable the find_notes tool. | true |
| JOPLIN_TOOL_UNTAG_NOTE | No | Enable or disable the untag_note tool. | true |
| JOPLIN_TOOL_UPDATE_TAG | No | Enable or disable the update_tag tool. | false |
| JOPLIN_TOOL_CREATE_NOTE | No | Enable or disable the create_note tool. | true |
| JOPLIN_TOOL_DELETE_NOTE | No | Enable or disable the delete_note tool. | false |
| JOPLIN_TOOL_PING_JOPLIN | No | Enable or disable the ping_joplin tool. | true |
| JOPLIN_TOOL_UPDATE_NOTE | No | Enable or disable the update_note tool. | true |
| JOPLIN_TOOL_FIND_IN_NOTE | No | Enable or disable the find_in_note tool. | true |
| JOPLIN_NOTEBOOK_ALLOWLIST | No | Comma-separated list of notebook patterns to allow access to. 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. | false |
| JOPLIN_TOOL_LIST_NOTEBOOKS | No | Enable or disable the list_notebooks tool. | true |
| JOPLIN_TOOL_CREATE_NOTEBOOK | No | Enable or disable the create_notebook tool. | true |
| JOPLIN_TOOL_DELETE_NOTEBOOK | No | Enable or disable the delete_notebook tool. | false |
| JOPLIN_TOOL_UPDATE_NOTEBOOK | No | Enable or disable the update_notebook tool. | false |
| JOPLIN_TOOL_GET_TAGS_BY_NOTE | No | Enable or disable the get_tags_by_note tool. | true |
| JOPLIN_TOOL_IMPORT_FROM_FILE | No | Enable or disable the import_from_file tool. | false |
| JOPLIN_TOOL_RESTORE_FROM_TRASH | No | Enable or disable the restore_from_trash tool. | true |
| JOPLIN_TOOL_FIND_NOTES_WITH_TAG | No | Enable or disable the find_notes_with_tag tool. | true |
| JOPLIN_TOOL_FIND_NOTES_IN_NOTEBOOK | No | Enable or disable the find_notes_in_notebook tool. | 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