조플린 노트 작성 애플리케이션을 위한 FastMCP 기반 모델 컨텍스트 프로토콜(MCP) 서버로, Python API joppy를 통해 AI 어시스턴트가 표준화된 인터페이스를 통해 조플린 노트, 노트북, 태그와 상호작용할 수 있습니다.

목차

• 할 수 있는 거
• 퀵 스타트
• 지원 클라이언트
• 예시 사용
• 도구 권한
• 노트북 허용 목록
• 고급 구성
• 도커
• 프로젝트 구조
• 시험
• 완전 공구 참고 자료
• 변경 기록

당신이 할 수 있는 것

이 MCP 서버는 포괄적인 조플린 통합을 위한 26개의 최적화 도구를 제공합니다:

노트 관리

• 찾기 및 검색: find_notes (폐기된 노트에 대해 trash=True 지원), find_notes_with_tag, find_notes_in_notebook, get_all_notes
• CRUD 연산: get_note, get_note_resources (첨부된 이미지/PDF에서 OCR 텍스트 읽기), get_links, create_note, update_note, edit_note, delete_note

노트북 관리

• 조직하기: list_notebooks, create_notebook, update_notebook, delete_notebook

태그 매니지먼트

• 분류: list_tags, create_tag, update_tag, delete_tag, get_tags_by_note
• 링크: tag_note, untag_note

Joplin MCP Server

A FastMCP-based Model Context Protocol (MCP) server for Joplin note-taking application via its Python API joppy, enabling AI assistants to interact with your Joplin notes, notebooks, and tags through a standardized interface.

Table of Contents

• What You Can Do
• Quick Start
• Supported Clients
• Example Usage
• Tool Permissions
• Notebook Allowlist
• Advanced Configuration
• Docker
• Project Structure
• Testing
• Complete Tool Reference
• Changelog

What You Can Do

This MCP server provides 26 optimized tools for comprehensive Joplin integration:

Note Management

• Find & Search: find_notes (supports trash=True for trashed notes), find_notes_with_tag, find_notes_in_notebook, get_all_notes
• CRUD Operations: get_note, get_note_resources (read OCR text from attached images/PDFs), get_links, create_note, update_note, edit_note, delete_note

Notebook Management

• Organize: list_notebooks, create_notebook, update_notebook, delete_notebook

Tag Management

• Categorize: list_tags, create_tag, update_tag, delete_tag, get_tags_by_note
• Link: tag_note, untag_note

Trash Management

• Recover: restore_from_trash - Restore soft-deleted notes or notebooks

Import

• File Import: import_from_file - Import Markdown, HTML, CSV, TXT, JEX files and directories

System

• Health: ping_joplin

Quick Start

1. Open Joplin Desktop → Tools → Options → Web Clipper
2. Enable the Web Clipper service
3. Copy the Authorization token
4. Set up your preferred client below

Supported Clients

Any MCP-compatible client should work. Below are the ones with documented setup instructions.

Claude Desktop

Run the automated installer:

# Install and configure everything automatically (pip)
pip install joplin-mcp
joplin-mcp-install

# Or use zero-install with uvx (recommended if you have uv)
uvx --from joplin-mcp joplin-mcp-install

# Optional: pin a specific version/range for stability
uvx --from joplin-mcp==0.4.1 joplin-mcp-install
uvx --from 'joplin-mcp>=0.4,<0.5' joplin-mcp-install

This script will:

• Configure your Joplin API token
• Set tool permissions (Create/Update/Delete)
• Set up Claude Desktop automatically
• Test the connection

After setup, restart Claude Desktop and you’re ready to go!

Claude Code

Install the orchestration plugin for smarter tool usage (edit vs update, long-note reading, bulk tagging):

/plugin marketplace add alondmnt/joplin-mcp
/plugin install joplin-mcp