joplin-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JOPLIN_HOST | No | Joplin Web Clipper host. | localhost |
| JOPLIN_PORT | No | Joplin Web Clipper port. | 41184 |
| JOPLIN_TOKEN | Yes | Auth token from Joplin Web Clipper. Required for access. | |
| JOPLIN_ALLOWED_NOTEBOOKS | No | Comma-separated list of notebook IDs or names. If unset, tools refuse to operate. Use '*' to allow all. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_notesC | Search Joplin notes by keyword. Returns matching note titles and ids. |
| get_noteA | Fetch the full content of a single Joplin note by its id. |
| create_noteA | Create a new note in the given notebook. Use list_notebooks to find a notebook_id. |
| update_noteA | Update an existing note's title and/or body. Only provided fields are changed. |
| delete_noteB | Delete a note by its id. Moves it to Joplin's trash rather than a permanent delete. |
| complete_todoB | Mark a to-do note complete or incomplete. Fails if the note isn't a to-do. |
| list_notes_in_notebookA | List notes in a notebook without a search query. Use list_notebooks to find a notebook_id. |
| list_notebooksA | List all Joplin notebooks (folders) with their ids, for use with create_note. |
| list_tagsA | List all Joplin tags with their ids, for use with get_notes_by_tag. |
| get_notes_by_tagA | List notes with a given tag. Use list_tags to find a tag_id. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/johnsarie27/joplin-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server