joplin-mcp-server

Overview

This is a well-documented MCP server that enables Joplin Desktop users to interact with their notes through the Model Context Protocol. It provides comprehensive functionality for searching, reading, creating, updating, and deleting notes, as well as importing markdown files. The server is designed to integrate seamlessly with AI assistants like Claude.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search_notes

  Search for notes in Joplin by query with optional limit

  Try:Search for notes about project managementTry:Find all notes containing the word 'meeting'
• get_note

  Retrieve a specific note by its ID

  Try:Get the note with ID 12345Try:Retrieve note content for my grocery list
• create_note

  Create a new note with optional title, body, parent_id and is_todo

  Try:Create a new note titled 'Meeting Notes'Try:Add a new todo item for 'Finish project'
• update_note

  Update an existing note's title, body, parent_id or todo status

  Try:Update the note with ID 12345 to have a new titleTry:Change the body of my project notes
• delete_note

  Delete a note by ID with option to permanently delete

  Try:Delete the note with ID 12345Try:Permanently remove the old meeting notes
• import_markdown

  Import a markdown file as a new note

  Try:Import markdown file /path/to/document.md as a noteTry:Convert README.md to a Joplin note

Comparable tools

Installation

# Clone repository
git clone https://github.com/dweigend/joplin-mcp.git
cd joplin-mcp

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

# Configure Joplin API Token
# Create .env file with JOPLIN_TOKEN=your_api_token_here

{
  "mcpServers": {
    "joplin": {
      "command": "/PATH/TO/UV/uv",
      "args": [
        "--directory",
        "/PATH/TO/YOUR/PROJECT/joplin_mcp",
        "run",
        "src/mcp/joplin_mcp.py"
      ]
    }
  }
}

FAQ

What Joplin version is required?

Joplin Desktop with Web Clipper Service enabled is required.

Can I use this with other AI assistants besides Claude?

Yes, any AI assistant that supports MCP protocol can use this server.

Compare joplin-mcp-server with