SkillFoxx

Joplin MCP

An MCP server for the Joplin notes app: an assistant searches, creates, edits, tags and restores notes from the trash.

  • 174 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • With write permissions on, the agent creates, edits and deletes notes, notebooks and tags.
  • Deletion is irreversible when the Delete permission is chosen.
All reasons and checks

alondmnt/joplin-mcpAuthor:alondmnt

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/joplin-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • With write permissions on, the agent creates, edits and deletes notes, notebooks and tags.
  • Deletion is irreversible when the Delete permission is chosen.

This is third-party code. Review the repository files before installing.

What it does

Joplin MCP is a FastMCP server that works with Joplin through its API (the joppy library). 26 tools cover notes (`find_notes`, `get_note`, `create_note`, `update_note`, `edit_note`, `delete_note`, OCR text from attached images and PDFs via `get_note_resources`, links via `get_links`), notebooks, tags, the trash (`restore_from_trash`) and importing Markdown, HTML, CSV, TXT and JEX files. Permission levels are chosen during setup: read is always on, create, update and delete are optional. A notebook allowlist (gitignore patterns such as `Work` or `Projects/**`, negations like `!Projects/Secret`) hides other notebook branches from the agent and blocks writes to them. For Claude Code there is a plugin with a `/joplin` skill that advises when to edit versus update a note, how to read long notes and how to bulk-tag.

Who it is for. Joplin users who want to search and maintain their notes with Claude Desktop, Claude Code, Jan AI or local Ollama models.

Good fit when

  • Find all notes on a topic and combine them into one summary.
  • Create a note for today meeting and tag it right away.
  • Process an attached PDF by reading the recognized text of the attachment.
  • Limit the agent to the Work and Projects notebooks and keep personal ones hidden.

Not a fit when

  • Syncing Joplin notes between devices is needed: Joplin itself does that.
  • The agent must not be trusted with deletion: keep read-only permissions.
  • The Joplin app is closed: the server works through its Web Clipper, which has to be enabled.

Example request

Find the Joplin notes about release planning, tag them with release and show a list with short summaries.

MCP

Transport
stdio
Authentication
API key

Environment variables

JOPLIN_TOKEN required, secret
Web Clipper authorization token from Joplin Desktop
JOPLIN_NOTEBOOK_ALLOWLIST
Comma-separated allowed notebooks, gitignore patterns

Limitations

A connection needs the Web Clipper enabled in Joplin Desktop (Tools, Options, Web Clipper) and its authorization token in `JOPLIN_TOKEN`. The `joplin-mcp-install` installer configures Claude Desktop and Jan AI automatically. Deletion is irreversible when the Delete permission is on. With an allowlist, creating a top-level notebook and moving to the top level are blocked so the agent cannot move a notebook out of the protected scope. The last commit dates from September 2026.

How to disable. Remove the joplin entry from the client config and turn off the Web Clipper in Joplin settings to close access by token.

FAQ

Where do I get the Joplin token?

In Joplin Desktop open Tools, Options, Web Clipper, enable the service and copy the authorization token.

How do I install it in Claude Code?

With `/plugin marketplace add alondmnt/joplin-mcp` and `/plugin install joplin-mcp`, the token is requested on first use.

Can deletion be forbidden?

Yes, setup offers Read, Write, Update and Delete levels, and read is always on.

How do I restrict notebooks?

With `notebook_allowlist` in `joplin-mcp.json` or the `JOPLIN_NOTEBOOK_ALLOWLIST` variable, using gitignore-style patterns.

Does the server run in Docker?

Yes, the README has a Docker section and the token setup is the same.

Discussion

No questions or reviews yet.

MCP servers

Joplin MCP Server opens your notes to an AI assistant: search, read, create, edit, delete and import Markdown files.

MCP serverExtended access96

An MCP server for Apple Notes on Mac: the agent reads, searches, creates, edits and exports notes and manages folders and tags.

MCP serverBroad access187
Official

Automattic's official Simplenote MCP server: an agent reads, searches and optionally edits notes, with no sign-in on macOS

MCP serverExtended access33

Obsidian MCP Server

obsidian-mcp-server

An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags

MCP serverExtended access704
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16

A local MCP server for safe read, search and edit of notes in an Obsidian vault, restricted to the vault root

MCP serverExtended access1.7K

README in short

The README lists 26 tools by group, a quick start through the Web Clipper, installation for Claude Desktop, Claude Code, Jan AI and OllMCP, permission levels, the notebook allowlist with patterns, Docker and a tool reference.

README badge

Report a problem