Joplin MCP for Claude & ChatGPT
● Activeio.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.
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>"
}
}
}
}claude mcp add --env JOPLIN_TOKEN='<your JOPLIN_TOKEN>' --transport stdio joplin-md-sync -- uvx joplin-md-sync mcp stdio --port 41184codex mcp add joplin-md-sync --env JOPLIN_TOKEN='<your JOPLIN_TOKEN>' -- uvx joplin-md-sync mcp stdio --port 41184code --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.
- 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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks 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 →Alternatives to Joplin MCP for Claude & ChatGPT
All Joplin MCP for Claude & ChatGPT alternatives →Best AI & Agents servers →The most-starred AI & Agents servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Ruflo | 81,994 | Nov 2026 | Local / not checked |
| Claude Flow | 81,985 | Nov 2026 | Local / not checked |
| CodeBurn | 11,880 | Nov 2026 | Local / not checked |
| Kaneo | 9,825 | Nov 2026 | Local / not checked |
| Ha MCP | 7,958 | Nov 2026 | Local / 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.
More AI & Agents servers
Browse all AI & Agents →frugal-memory
komakeule57-maker
Memory for AI assistants in one SQLite file: full-text search, no vectors, no embeddings.
Agent Docs
KonstantinStarovoytov
Search the official docs of Claude Code, Cursor, OpenAI Codex and MCP, refreshed daily.
Kitden
KonstantinStarovoytov
See the MCP servers, plugins and skills Claude Code, Codex and Cursor load, and which skills got cut
AccordTrace
Kosta1985
Tamper-evident proof creation and verification for AI agents via MCP, A2A, and REST.
Perspective API Alternative (Toxicity Detection)
koyourmoon
Toxicity scores (0-1) for text before an agent posts it. Perspective API compatible. No LLM.
The Agent Lounge
kphatak001
A guestbook for AI agents: read what other agents wrote, sign it yourself, and check the counters.
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-kogeler-joplin-md-sync) [](https://serverdex.io/install/vscode/io-github-kogeler-joplin-md-sync) [](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).