Skip to content
MCP server

Joplin MCP for Claude & ChatGPT

Self-hosted MCP server giving Claude and ChatGPT controlled access to your Joplin notes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, Linux
Runs
Locally
Version
1.8.1
Listing updated
today

Similar MCP servers

About Joplin MCP for Claude & ChatGPT

Joplin MCP for Claude & ChatGPT is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

The README says this project connects AI assistants to a Joplin notebook that stays on your own server or desktop. Hosted Claude can sign in through a GitHub account via OAuth built into the server, while a private Custom GPT reaches notes through authenticated Actions. Local MCP clients can use stdio or Streamable HTTP instead.

The bridge talks to Joplin's local Data API and does not edit the Joplin database or sync target directly. Joplin remains the system of record, and the project offers an installer that sets up headless Joplin Terminal, recurrent sync and the adapter as Linux user services.

It also includes a Markdown workflow that pulls notebooks into files, shows three-way diffs and dry-run pushes before writing back, which suits people who want to review agent edits before they reach Joplin.

Install

Run in a terminal

claude mcp add joplin-md-sync --env JOPLIN_TOKEN='<JOPLIN_TOKEN>' -- uvx joplin-md-sync

Add to claude_desktop_config.json

{
  "mcpServers": {
    "joplin-md-sync": {
      "command": "uvx",
      "args": [
        "joplin-md-sync"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "joplin-md-sync": {
      "command": "uvx",
      "args": [
        "joplin-md-sync"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "joplin-md-sync": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "joplin-md-sync"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "joplin-md-sync": {
      "command": "uvx",
      "args": [
        "joplin-md-sync"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "joplin-md-sync": {
      "command": "uvx",
      "args": [
        "joplin-md-sync"
      ],
      "env": {
        "JOPLIN_TOKEN": "<JOPLIN_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • JOPLIN_TOKENJoplin Web Clipper authorization tokenRequired

What it does

Hosted Claude sign-in
Claude on claude.ai can connect through a GitHub login handled by the server itself, with no separate OAuth proxy.
Private Custom GPT access
Authenticated Actions let a private ChatGPT Custom GPT search, read and change current Joplin notes.
Typed MCP tools
Local stdio and Streamable HTTP transports expose structured note, notebook, tag and attachment operations.
Headless Linux installer
A single installer deploys Joplin Terminal, recurrent sync and the adapter as rootless systemd services.
Reviewable Markdown sync
Notebooks can be pulled to files, compared with three-way diffs and pushed after a dry run.
Explicit failure handling
Duplicate creates return explicit errors and ambiguous write timeouts are reported rather than replayed.

Good for

  • Search and summarise your Joplin notes from Claude or a private ChatGPT GPT
  • Save meeting follow-ups or decision records into a named Joplin notebook from a conversation
  • Let a coding assistant read runbooks in Joplin and update targeted notes via MCP
  • Keep Joplin notes reachable from assistants while the desktop app is closed, on a headless server
  • Edit selected notebooks as Markdown files in Git and push reviewed changes back to Joplin

Pricing

Open source

Free and MIT licensed; self-hosted.

Prices change. Check joplin-mcp.romancello.net before you buy.

Joplin MCP for Claude & ChatGPT FAQ

Does it need Joplin Desktop running?

The README says the headless installer runs Joplin Terminal as a service, so Joplin Desktop does not need to stay open. Running beside Joplin Desktop is also supported.

Which storage backends are supported?

The README lists filesystem, Nextcloud, WebDAV, Dropbox, OneDrive, S3, Joplin Server and Joplin Cloud, with existing Joplin end-to-end encryption where the topology supports it.

Is ChatGPT MCP supported yet?

Not yet. The README says a ChatGPT MCP connector through the same built-in OAuth is planned, and that private Custom GPTs currently work through Actions.

What is the licence?

The README states the project is MIT licensed and is not affiliated with the Joplin project.

Is Joplin MCP for Claude & ChatGPT free?

Yes. Joplin MCP for Claude & ChatGPT is open source, so you can use and self-host it for free.

How do I add Joplin MCP for Claude & ChatGPT to Claude Code?

Run this command in your terminal: claude mcp add joplin-md-sync --env JOPLIN_TOKEN='<JOPLIN_TOKEN>' -- uvx joplin-md-sync

What are the best alternatives to Joplin MCP for Claude & ChatGPT?

The closest alternatives to Joplin MCP for Claude & ChatGPT are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Joplin MCP for Claude & ChatGPT

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 467K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.8K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    • Remote
    • Open source
    • 34.6K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools