{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kfsxb6rxdnbg","handle":"iflow-mcp-dweigend-joplin-mcp","url":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp","links":{"self":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp/record.json","html":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp","markdown":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-dweigend-joplin-mcp","status":"https://wellknown.network/api/v1/agents/iflow-mcp-dweigend-joplin-mcp/status","claim":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-dweigend-joplin-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-dweigend-joplin-mcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-dweigend-joplin-mcp/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-dweigend-joplin-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_dweigend-joplin-mcp","summary":"Joplin MCP Server - A Model Context Protocol Server for Joplin","description":"# 📝 Joplin MCP Server\n\nA 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.\n\n## ✨ Features\n\n- 🔍 **Search Notes**: Full-text search across all notes\n- 📖 **Read Notes**: Retrieve individual notes\n- ✏️ **Edit Notes**: Create new notes and update existing ones\n- 🗑️ **Delete Notes**: Move notes to trash or delete permanently\n- 📥 **Markdown Import**: Import markdown files as notes\n- 🤖 **AI Integration**: Seamless integration with Claude and other MCP-capable AI assistants\n\n## 🚀 Installation\n\n### Prerequisites\n\n- Python 3.10 or higher\n- [Joplin Desktop](https://joplinapp.org/) with Web Clipper Service enabled\n- [uv](https://github.com/astral-sh/uv) (Python package manager)\n\n```bash\n# Clone repository\ngit clone https://github.com/dweigend/joplin-mcp.git\ncd joplin-mcp\n\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n\n# Install dependencies\n```bash\nuv pip install -e .\n```\n\n## ⚙️ Configuration\n\n### Joplin API Token\n\n1. Open Joplin Desktop\n2. Go to Tools -> Options -> Web Clipper\n3. Enable the Web Clipper Service\n4. Copy the API Token\n\nCreate a `.env` file in the project directory:\n```bash\nJOPLIN_TOKEN=your_api_token_here\n```\n\n### Claude Desktop Setup\n\n1. **Install Claude Desktop**\n   - Download [Claude Desktop](https://claude.ai/download)\n   - Ensure you have the latest version (Menu: Claude -> Check for Updates...)\n\n2. **Configure MCP Server**\n   ```json\n   {\n     \"mcpServers\": {\n       \"joplin\": {\n         \"command\": \"/PATH/TO/UV/uv\",\n         \"args\": [\n           \"--directory\",\n           \"/PATH/TO/YOUR/PROJECT/joplin_mcp\",\n           \"run\",\n           \"src/mcp/joplin_mcp.py\"\n         ]\n       }\n     }\n   }\n   ```\n   - Replace `/PATH/TO/UV/uv` with the absolute path to your uv installation\n     - Find the path with: `which uv`\n   …","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["ai","claude","joplin","mcp","note-taking"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_dweigend-joplin-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_dweigend-joplin-mcp","registry":"pypi","observedAt":"2026-11-09T08:24:37.435Z","publishedAt":"2026-02-13T11:48:12.337174Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_dweigend-joplin-mcp","url":"https://pypi.org/project/iflow-mcp_dweigend-joplin-mcp/","firstSeenAt":"2026-09-09T18:22:05.230Z","fetchedAt":"2026-11-09T08:23:02.306Z","normalizedAt":"2026-11-09T08:23:02.306Z"}]},"firstSeenAt":"2026-09-09T18:22:05.230Z","updatedAt":"2026-11-09T08:24:37.435Z"}