iflow-mcp_dweigend-joplin-mcp

# 📝 Joplin MCP Server A Model Context Protocol (MCP) Server for [Joplin](https://joplinapp.org/) that enables note access through the [Model Context Protocol](https://modelcontextprotocol.io). 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](https://joplinapp.org/) with Web Clipper Service enabled - [uv](https://github.com/astral-sh/uv) (Python package manager) ```bash # Clone repository git clone https://github.com/dweigend/joplin-mcp.git cd joplin-mcp # Create and activate virtual environment uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies ```bash uv pip install -e . ``` ## ⚙️ Configuration ### Joplin API Token 1. Open Joplin Desktop 2. Go to Tools -> Options -> Web Clipper 3. Enable the Web Clipper Service 4. Copy the API Token Create a `.env` file in the project directory: ```bash JOPLIN_TOKEN=your_api_token_here ``` ### Claude Desktop Setup 1. **Install Claude Desktop** - Download [Claude Desktop](https://claude.ai/download) - Ensure you have the latest version (Menu: Claude -> Check for Updates...) 2. **Configure MCP Server** ```json { "mcpServers": { "joplin": { "command": "/PATH/TO/UV/uv", "args": [ "--directory", "/PATH/TO/YOUR/PROJECT/joplin_mcp", "run", "src/mcp/joplin_mcp.py" ] } } } ``` - Replace `/PATH/TO/UV/uv` with the absolute path to your uv installation - Find the path with: `which uv` …