joplin-mcp

Overview

The Joplin MCP Server provides comprehensive integration between AI assistants and the Joplin note-taking application. It exposes 25 tools covering note management, notebook organization, tag operations, trash management, file import, and system health checks. The server supports permission levels to control AI access and features a sophisticated notebook allowlist system using gitignore-pattern syntax for fine-grained access control.

Try asking AI

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

• find_notes

  Search for notes in Joplin, with optional trash filter

  Try:Find all my Python programming notesTry:Find notes about machine learning
• find_notes_with_tag

  Find notes that contain a specific tag

  Try:Show me all notes tagged 'important'Try:Find notes with the 'work' tag
• find_notes_in_notebook

  Find notes within a specific notebook

  Try:Show me all notes in the 'meetings' notebookTry:Find notes in my 'projects' notebook
• get_note

  Retrieve the full content of a specific note

  Try:Get the content of note with ID 12345Try:Show me the details of my weekly summary note
• create_note

  Create a new note in Joplin

  Try:Create a new note about today's meetingTry:Make a note titled 'Shopping list'
• update_note

  Update an existing note with new content

  Try:Update my weekly report with new dataTry:Fix typos in my project notes
• list_notebooks

  List all notebooks in your Joplin workspace

  Try:Show me all my notebooksTry:List my notebook organization
• create_notebook

  Create a new notebook in Joplin

  Try:Create a new notebook called 'vacation 2023'Try:Make a 'research' notebook
• list_tags

  List all tags in your Joplin workspace

  Try:Show me all my tagsTry:List existing tags for organization
• create_tag

  Create a new tag in Joplin

  Try:Create a new tag called 'urgent'Try:Make a tag for client projects
• tag_note

  Add a tag to an existing note

  Try:Tag my meeting notes as 'important'Try:Add the 'research' tag to article notes
• ping_joplin

  Check connectivity to Joplin server

  Try:Check if Joplin is accessibleTry:Test connection to Joplin

Comparable tools

Installation

# Install and configure automatically
pip install joplin-mcp
joplin-mcp-install

{
  "mcpServers": {
    "joplin": {
      "command": "uvx",
      "args": ["--from", "joplin-mcp", "joplin-mcp-server"],
      "env": {
        "JOPLIN_TOKEN": "your_token_here"
      }
    }
  }
}

/plugin marketplace add alondmnt/joplin-mcp
/plugin install joplin-mcp

FAQ

How do I restrict access to specific notebooks?

Use the notebook allowlist feature with gitignore-pattern syntax. Configure via JSON file or JOPLIN_NOTEBOOK_ALLOWLIST environment variable.

What permission levels are available?

The server offers 4 permission levels: Read (always enabled), Write (create content), Update (modify content), and Delete (remove content).

Compare joplin-mcp with