Joplin MCP for Claude & ChatGPT

● Active

io.github.kogeler/joplin-md-sync

Self-hosted Joplin MCP server with built-in OAuth for hosted Claude and ChatGPT Actions

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "joplin-md-sync": {
      "command": "uvx",
      "args": [
        "joplin-md-sync",
        "mcp",
        "stdio",
        "--port",
        "41184"
      ],
      "env": {
        "JOPLIN_TOKEN": "<your JOPLIN_TOKEN>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env JOPLIN_TOKEN='<your JOPLIN_TOKEN>' --transport stdio joplin-md-sync -- uvx joplin-md-sync mcp stdio --port 41184
OpenAI Codex CLI
codex mcp add joplin-md-sync --env JOPLIN_TOKEN='<your JOPLIN_TOKEN>' -- uvx joplin-md-sync mcp stdio --port 41184
VS Code
code --add-mcp '{"name":"joplin-md-sync","type":"stdio","command":"uvx","args":["joplin-md-sync","mcp","stdio","--port","41184"],"env":{"JOPLIN_TOKEN":"<your JOPLIN_TOKEN>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • JOPLIN_TOKENrequiredsecretJoplin Web Clipper authorization token

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
AI & Agents
Version
1.8.1
Registry
active
Published
11/15/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Joplin MCP for Claude & ChatGPT is maintained, open source.

Maintained
Active
Last commit 6 days ago (Nov 16, 2026), 1 open issues.
Official registry
Active
Published as io.github.kogeler/joplin-md-sync in the official MCP registry, version 1.8.1.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
On your machine
A local PyPI package started by your client; it can reach whatever your user account can.
Credentials
1 required
Declared environment variables: JOPLIN_TOKEN. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 22, 2026
Stars
0
Forks
0
Last push
Nov 16, 2026
License
MIT

Pythonai-agentschatgptclaudejoplinmarkdownmcpmcp-servermodel-context-protocolnotesoauthpythonself-hosted

From the README

Joplin MCP for Claude and ChatGPT joplin-md-sync gives AI assistants controlled access to your own Joplin knowledge base. Search, read, create, update, move, tag, and trash notes from hosted Claude with a GitHub login, a private Custom GPT, or any local stdio or Streamable HTTP MCP client without moving your notes into another hosted note service. • Built-in OAuth for hosted Claude. Claude on claude.ai connects straight to Joplin on your own server through your GitHub login. OAuth is part of the server itself, so there is no separate OAuth proxy or gateway to deploy and configure, and the Joplin Data API stays on loopback. • ChatGPT today. A private Custom GPT works through authenticated Actions. OpenAI retires Custom GPTs on 2026-12-11; a ChatGPT MCP connector through the same built-in OAuth is planned as the replacement. • One installer for the whole stack. A single command sets up headless Joplin Terminal, recurrent sync, MCP, Actions, and Claude OAuth as rootless systemd services. It asks for the values it needs, hides secrets, generates keys and tokens, and verifies the result. Run it beside Joplin Desktop, or deploy the complete headless stack on your own Linux host. A separate Markdown sync workflow is available when a coding agent needs reviewable files, three-way diffs, and Git history. Website · Connect Claude · Connect ChatGPT · MCP: local stdio & HTTP · Deploy headless What you get • Claude with GitHub sign-in.…

Read the full README on GitHub →

The most-starred AI & Agents servers in the index, with their live-check result.

ServerStarsLast pushLive check
Ruflo81,994Nov 2026Local / not checked
Claude Flow81,985Nov 2026Local / not checked
CodeBurn11,880Nov 2026Local / not checked
Kaneo9,825Nov 2026Local / not checked
Ha MCP7,958Nov 2026Local / not checked

Joplin MCP for Claude & ChatGPT: questions people ask

Is Joplin MCP for Claude & ChatGPT a remote or a local MCP server?
According to its entry in the official MCP registry, Joplin MCP for Claude & ChatGPT ships as a local package (PyPI) that your client starts on your machine.
Does Joplin MCP for Claude & ChatGPT need an API key?
Its registry entry declares one required environment variable: JOPLIN_TOKEN. The config on this page shows where each goes.
Is Joplin MCP for Claude & ChatGPT safe to use?
Looks healthy: Joplin MCP for Claude & ChatGPT is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 1 required. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Joplin MCP for Claude & ChatGPT still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
How do I add Joplin MCP for Claude & ChatGPT to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all AI & Agents →

Add the badge to your site

Show visitors that Joplin MCP for Claude & ChatGPT is listed here — it’s also the link we check for a free listing.

Joplin MCP for Claude & ChatGPT — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-kogeler-joplin-md-sync?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Joplin MCP for Claude & ChatGPT — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Joplin MCP for Claude & ChatGPT — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-kogeler-joplin-md-sync?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-kogeler-joplin-md-sync) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-kogeler-joplin-md-sync) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-kogeler-joplin-md-sync)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-kogeler-joplin-md-sync"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-kogeler-joplin-md-sync"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-kogeler-joplin-md-sync"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).