joplin-mcp-server

概述

这是一个文档完备的 MCP 服务器，允许用户通过模型上下文协议与 Joplin Desktop 笔记进行交互。它提供了全面的功能，包括搜索、读取、创建、更新和删除笔记，以及导入 markdown 文件。该服务器专为与 Claude 等 AI 助手无缝集成而设计。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• search_notes

  Search for notes in Joplin by query with optional limit

  试试:Search for notes about project management试试:Find all notes containing the word 'meeting'
• get_note

  Retrieve a specific note by its ID

  试试:Get the note with ID 12345试试:Retrieve note content for my grocery list
• create_note

  Create a new note with optional title, body, parent_id and is_todo

  试试:Create a new note titled 'Meeting Notes'试试:Add a new todo item for 'Finish project'
• update_note

  Update an existing note's title, body, parent_id or todo status

  试试:Update the note with ID 12345 to have a new title试试:Change the body of my project notes
• delete_note

  Delete a note by ID with option to permanently delete

  试试:Delete the note with ID 12345试试:Permanently remove the old meeting notes
• import_markdown

  Import a markdown file as a new note

  试试:Import markdown file /path/to/document.md as a note试试:Convert README.md to a Joplin note

可对比工具

安装

# 克隆仓库
git clone https://github.com/dweigend/joplin-mcp.git
cd joplin-mcp

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
uv pip install -e .

# 配置 Joplin API 令牌
# 创建包含 JOPLIN_TOKEN=your_api_token_here 的 .env 文件

{
  "mcpServers": {
    "joplin": {
      "command": "/PATH/TO/UV/uv",
      "args": [
        "--directory",
        "/PATH/TO/YOUR/PROJECT/joplin_mcp",
        "run",
        "src/mcp/joplin_mcp.py"
      ]
    }
  }
}

FAQ

需要什么版本的 Joplin？

需要启用了 Web Clipper 服务的 Joplin Desktop。

除了 Claude，我还可以与其他 AI 助手一起使用吗？

可以，任何支持 MCP 协议的 AI 助手都可以使用此服务器。

joplin-mcp-server 对比