Jopmcp

Jopmcp

Jopmcp is a MCP server for Joplin, a note-taking and to-do application with synchronization capabilities. My implementation of this MCP is largely inspired by this one, but adapted to my needs. In particular:

• Docker is used to run the server (I run all my MCPs in Docker).
• It supports paths: Notebook > Subnotebook > Note Title, so the LLM understand the hierarchy of notes.

I felt the need to implement this MCP myself because Joplin is an essential tool for me (storing very sensitive data) so I wanted to have full control over the implementation of the MCP.

Run in docker-compose

I normally run all my MCPs in Docker. I have a docker-compose.yml file somewhere that spins up all my MCPs. To run this MCP, follow these steps:

1. Configure Joplin
   • Open Joplin Desktop → Tools → Options → Web Clipper
   • Enable the Web Clipper service
   • Copy the Authorization token
2. Set the environment variable JOPLIN_TOKEN with the token you copied from Joplin. You can do this in your shell or in a .env file.
3. Build the jopmcp image: make pkg
4. Run the MCP with docker-compose up -d

The network mode needs to be set to host so that the MCP can access the Joplin web clipper API, running on localhost:41184 by default. If you're running the web clipper on a different port, you can set the JOPLIN_WEB_CLIPPER_URL env var.

Docs

• Joplin data API
• Joplin search