# Joplin MCP Server (MCP server)

> Joplin MCP Server is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. FastMCP server exposing Joplin notes, notebooks, tags, and imports. It has 172 GitHub stars, is released under the MIT license and runs locally with uvx joplin-mcp.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/alondmnt/joplin-mcp |
| GitHub stars | 172 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: joplin-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v0.10.0 (Sep 12, 2026) |
| Last commit | Sep 12, 2026 |
| MCP registry name | io.github.alondmnt/joplin-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "joplin-mcp-server": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env JOPLIN_TOKEN=your-value --transport stdio joplin-mcp-server -- uvx joplin-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "joplin-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "joplin_token",
      "description": "JOPLIN_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "joplin-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ],
      "env": {
        "JOPLIN_TOKEN": "${input:joplin_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `JOPLIN_TOKEN` (secret) (required): Web Clipper authentication token from a running Joplin instance
- `JOPLIN_URL`: Optional override for the Joplin Web Clipper base URL (default http://localhost:41184)

## Similar MCP servers

- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,368 stars, MIT, official, needs API key)
- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,192 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (7,725 stars, MIT)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create, read and edit Excel workbooks without Microsoft Excel. (4,212 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,108 stars, AGPL-3.0)
- [RevoGrid DataGrid MCP](https://appsgit.com/mcp-servers/revogrid-datagrid-mcp): Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval. (3,448 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/joplin-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.