joplin-mcp-server
14
The Joplin MCP Server facilitates note management for Joplin via the Model Context Protocol, allowing integration with AI assistants like Claude. It offers functionalities such as searching, editing, and managing notes, along with Markdown import.
📝 Joplin MCP Server
A Model Context Protocol (MCP) Server for Joplin that enables note access through the Model Context Protocol. Perfect for integration with AI assistants like Claude.
✨ Features
- Search Notes: Full-text search across all notes
- Read Notes: Retrieve individual notes
- Edit Notes: Create new notes and update existing ones
- Delete Notes: Move notes to trash or delete permanently
- Markdown Import: Import markdown files as notes
- AI Integration: Seamless integration with Claude and other MCP-capable AI assistants
🚀 Installation
Prerequisites
- Python 3.10 or higher
- Joplin Desktop with Web Clipper Service enabled
- UV (Python package manager)
⚙️ Configuration
Joplin API Token
- Open Joplin Desktop
- Go to Tools -> Options -> Web Clipper
- Enable the Web Clipper Service
- Copy the API Token
🧪 Development
Debug Mode
To start the server in debug mode, use MCP_LOG_LEVEL=debug mcp dev src/mcp/joplin_mcp.py.