joplin-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log level: debug, info, warn, or error | info |
| JOPLIN_HOST | No | Joplin hostname or IP address | 127.0.0.1 |
| JOPLIN_PORT | No | Joplin port number | 41184 |
| JOPLIN_TOKEN | Yes | Your Joplin API token (found in Tools > Options > Web Clipper) |
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 |
|---|---|
| list_notebooksB | Retrieve the complete notebook hierarchy from Joplin |
| search_notesC | Search for notes in Joplin and return matching notebooks |
| read_notebookC | Read the contents of a specific notebook |
| read_noteC | Read the full content of a specific note |
| read_multinoteC | Read the full content of multiple notes at once |
| create_noteC | Create a new note in Joplin |
| create_folderC | Create a new folder/notebook in Joplin |
| edit_noteC | Edit/update an existing note in Joplin |
| edit_folderC | Edit/update an existing folder/notebook in Joplin |
| delete_noteB | Delete a note from Joplin (requires confirmation) |
| delete_folderA | Delete a folder/notebook from Joplin (requires confirmation) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are organized around specific resources (folders/notebooks, notes) and actions (create, delete, edit, list, read, search), making it easy for an agent to select the right tool for any task.
Tool names follow a consistent verb_noun pattern throughout (e.g., create_folder, delete_note, edit_note, list_notebooks). All tools use snake_case and clear, descriptive verbs that match their actions precisely.
With 11 tools, this server is well-scoped for managing Joplin notes and notebooks. Each tool earns its place by covering essential CRUD operations and additional utilities like search and multi-note reading, without being overwhelming or too sparse.
The toolset provides complete CRUD/lifecycle coverage for both folders/notebooks and notes, including create, read, edit, delete, list, and search operations. There are no obvious gaps, ensuring agents can handle all core workflows without dead ends.