Skip to main content
Glama
johnsarie27

joplin-mcp

by johnsarie27

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
JOPLIN_HOSTNoJoplin Web Clipper host.localhost
JOPLIN_PORTNoJoplin Web Clipper port.41184
JOPLIN_TOKENYesAuth token from Joplin Web Clipper. Required for access.
JOPLIN_ALLOWED_NOTEBOOKSNoComma-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

CapabilityDetails
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

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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