# joplin-mcp — MCP Server for Joplin Notes

> joplin-mcp is an MCP server for Joplin that lets agents read/search/edit notes; includes an installer for Claude Desktop and a Claude Code plugin.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
pip install joplin-mcp
joplin-mcp-install
# or zero-install:
uvx --from joplin-mcp joplin-mcp-install
# Claude Code plugin:
/plugin marketplace add alondmnt/joplin-mcp
```

## Intro

joplin-mcp is an MCP server for Joplin that lets agents read/search/edit notes; includes an installer for Claude Desktop and a Claude Code plugin.

**Best for:** turning your personal note base into an agent-accessible knowledge tool

**Works with:** Joplin Desktop API, Claude Desktop, Claude Code, Jan AI (per README)

**Setup time:** 5-15 minutes

### Key facts (verified)

- GitHub: 110 stars · 11 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `pip install joplin-mcp`.

## Main

- Use `joplin-mcp-install` (or `uvx --from joplin-mcp ...`) to automate token wiring and client configuration instead of editing JSON by hand.

- If you’re on Claude Code, install the orchestration plugin so the agent can pick better read/update strategies for long notes and bulk tagging.

- Treat note access as scoped automation: keep write tools enabled only when you actually need Create/Update/Delete permissions.

### Source-backed notes

- README shows an automated installer flow: `pip install joplin-mcp` then `joplin-mcp-install` (or `uvx --from joplin-mcp joplin-mcp-install`).
- README includes Claude Code plugin install commands (`/plugin marketplace add alondmnt/joplin-mcp` and `/plugin install joplin-mcp`).
- README documents client setups for Claude Desktop and other MCP-compatible clients, and notes that Joplin API token is required.

### FAQ

- **Do I need to edit config files manually?**: Not usually — README recommends the installer which configures clients automatically.
- **Can I pin a version for stability?**: Yes — README shows `uvx --from joplin-mcp==...` and range pinning examples.
- **Does it support Claude Code?**: Yes — README includes a Claude Code plugin flow via `/plugin marketplace add` + `/plugin install`.

## Source & Thanks

> Source: https://github.com/alondmnt/joplin-mcp
> License: MIT
> GitHub stars: 110 · forks: 11

---

<!-- ZH -->

## Quick Use

```bash
pip install joplin-mcp
joplin-mcp-install
# or zero-install:
uvx --from joplin-mcp joplin-mcp-install
# Claude Code plugin:
/plugin marketplace add alondmnt/joplin-mcp
```

## Intro

joplin-mcp 是 Joplin 的 MCP server，可让 agent 读取/搜索/编辑笔记与批量处理；提供安装脚本自动配置 Claude Desktop，并支持 Claude Code 插件增强工具编排。

**Best for:** 把个人笔记库变成 agent 可调用的知识工具

**Works with:** Joplin Desktop API；Claude Desktop / Claude Code；Jan AI（README）

**Setup time:** 5-15 minutes

### Key facts (verified)

- GitHub：110 stars · 11 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`pip install joplin-mcp`。

## Main

- 优先用 `joplin-mcp-install`（或 `uvx --from joplin-mcp ...`）自动完成 token 与客户端配置，避免手工改 JSON 出错。

- 在 Claude Code 场景下安装编排插件，让 agent 在长笔记读取、批量打 tag 等操作上更聪明地选工具与策略。

- 把笔记写入当作受控自动化：只有确实需要时再开启 Create/Update/Delete 权限，降低误操作风险。

### Source-backed notes

- README 给出自动安装流程：`pip install joplin-mcp` 后运行 `joplin-mcp-install`（或用 `uvx --from ...` 零安装）。
- README 给出了 Claude Code 插件安装命令（`/plugin marketplace add ...` 与 `/plugin install ...`）。
- README 列出 Claude Desktop 等客户端配置方式，并强调需要提供 Joplin API token。

### FAQ

- **需要手工改配置文件吗？**：通常不需要。README 推荐使用安装脚本自动写入客户端配置。
- **能固定版本吗？**：可以。README 展示了 `uvx --from joplin-mcp==...` 以及范围约束示例。
- **支持 Claude Code 吗？**：支持。README 给出通过 `/plugin marketplace add` + `/plugin install` 安装插件的流程。

## Source & Thanks

> Source: https://github.com/alondmnt/joplin-mcp
> License: MIT
> GitHub stars: 110 · forks: 11


---
Source: https://tokrepo.com/en/workflows/joplin-mcp-mcp-server-for-joplin-notes
Author: MCP Hub