joplin-mcp-server

jordanburke/joplin-mcp-server

3.3

If you are the rightful owner of joplin-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Node.js implementation of an MCP (Model Context Protocol) server for Joplin.

The Joplin MCP Server is a robust Node.js application designed to facilitate seamless interaction with the Joplin note-taking application through the Model Context Protocol (MCP). This server allows users to manage their Joplin notebooks and notes programmatically, providing a powerful tool for developers and advanced users who wish to automate or extend the functionality of Joplin. By leveraging the Joplin API, the server can perform a variety of tasks such as listing notebooks, searching for notes, and reading note contents. The server is highly configurable, allowing users to specify custom ports and API tokens through environment variables or command-line arguments. Additionally, it supports logging at various levels, enabling users to monitor and debug their interactions with the Joplin application effectively.

Features

  • Node.js implementation for easy integration with Joplin.
  • Supports listing, searching, and reading notes and notebooks.
  • Configurable via environment variables and command-line arguments.
  • Detailed logging with adjustable log levels.
  • Compatible with npx for easy execution without installation.

Usages

npx with Augment Code

name: joplin
command: npx joplin-mcp-server --port 41184 --token your_token

npx with mcp.json

{
  "joplin": {
    "command": "npx",
    "args": ["joplin-mcp-server", "--port", "41184", "--token", "your_joplin_token"]
  }
}

npx with mcp.json using environment file

{
  "joplin": {
    "command": "npx",
    "args": ["joplin-mcp-server", "--env-file", "/path/to/your/.env"]
  }
}

node with Augment Code

name: joplin
command: node /path/to/your/mcp-joplin/index.js --env-file /path/to/your/mcp-joplin/.env

node with mcp.json

{
  "joplin": {
    "command": "node",
    "args": [
      "/path/to/your/mcp-joplin/index.js",
      "--env-file",
      "/path/to/your/mcp-joplin/.env"
    ]
  }
}

Tools

  1. list_notebooks

    Retrieves the complete notebook hierarchy from Joplin.

  2. search_notes

    Searches for notes in Joplin and returns matching notebooks.

  3. read_notebook

    Reads the contents of a specific notebook.

  4. read_note

    Reads the full content of a specific note.

  5. read_multinote

    Reads the full content of multiple notes at once.