Key Takeaways
- Built by independent developer HugoValim as an open-source community plugin β not an official Joplin product
- License: MIT, per the GitHub repository
- Connects via a generic OpenAI-compatible HTTP/SSE endpoint β no vendor SDK β with Ollama's default local port (
http://localhost:11434/v1) as the default base URL - Also works with LM Studio or the OpenAI API by changing the base URL in settings
- Requires Joplin 3.6+; desktop only β explicitly does not support Joplin mobile
- Every note or file change is shown as a temporary diff document for review before it is applied β nothing is written silently
- Undo keeps up to ten runs for up to seven days; concurrency uses timestamp-based conflict detection
- Optional semantic search over notes (RAG) requires Joplin 3.7+
π In One Sentence
Joplin AI Agent is a community plugin that adds a review-gated AI chat agent to the Joplin notes app, connecting to any OpenAI-compatible endpoint including fully local Ollama and LM Studio servers.
π¬ In Plain Terms
It puts an AI chat panel inside Joplin that can read your notes and, only after you approve a shown diff, make edits. You point it at a model running on your own computer through Ollama or LM Studio instead of a cloud subscription, so your notes can stay entirely on your machine.
πNote: This review is the deep-dive companion to Joplin AI Agent's entry in the Local LLM Software Directory β see that page for how it compares at a glance to dozens of other local-AI-capable tools.
What Is Joplin AI Agent?
Joplin AI Agent is a community plugin for Joplin, the open-source, cross-platform notes app, built by independent developer HugoValim and distributed as open-source software under the MIT license. Per its own GitHub repository, it adds an AI agent with tool-based read and write access to notes, notebooks, and text files inside a Joplin profile, with every proposed change routed through a review step before it touches your data.
- Plugin ID:
com.hugovalim.joplin-ai-agent - Version 0.7.0 as of this review β check the repository directly for the current release, since plugin versions change independently of this article
- Core function: a sidebar chat agent that can search, read, and β with your review β edit notes, notebooks, and text files inside your Joplin profile
- Local inference: no bundled inference engine β the plugin sends requests to a separately running OpenAI-compatible server (Ollama, LM Studio, or a cloud API) rather than shipping model weights itself
- Developer: HugoValim, an independent developer distributing the plugin as open-source software, not affiliated with Joplin's maintainers
- Canonical repository: github.com/HugoValim/joplin-ai-plugin
What Can You Do With Joplin AI Agent?
Joplin AI Agent combines vault-aware chat, tool-based file access, and a review step before any write, per its own README.
- Persistent chat transcripts β conversations keep context settings and run summaries across sessions, rather than resetting with every new chat
- Optional note retrieval (RAG) β semantic search over your notes so answers can use vault content as context; this specific feature requires Joplin 3.7 or newer
- Anti-injection and anti-fabrication rules β the plugin documents rules designed to prevent prompt injection from note content and to reduce fabricated citations when the agent writes about your notes
- Tool-based read/write access β the agent can read and propose edits to notes, notebooks, and plain text files, not only chat about them
- Review-required change proposals β any proposed edit is shown as a temporary diff document before it is applied, so you approve or reject the exact change rather than having it written silently
- Timestamp-based conflict detection β the plugin checks note modification timestamps to catch concurrent edits before applying a change, reducing the risk of silently overwriting a note you edited elsewhere
- Undo history β retains up to ten runs for up to seven days, so a bad agent-made edit can be reverted after the fact
- Sidebar UI with keyboard shortcuts β the chat panel lives in Joplin's sidebar with keyboard shortcuts and paginates long transcripts at 100 messages per page
- External folder workspace support β can work against files in an external folder outside the Joplin profile, respecting that folder's
.gitignore
How to Connect Joplin AI Agent to a Local Model
Joplin AI Agent talks to any OpenAI-compatible HTTP/SSE endpoint β there is no vendor-specific SDK to configure. The default base URL, http://localhost:11434/v1, matches Ollama's default local server port, so a standard local Ollama install works with no URL change at all.
Base URL
API key
- What to Enter:
- Optional for most local servers; required for cloud providers that enforce one.
Model name
- What to Enter:
- The exact model identifier as reported by your backend (for example, an Ollama model tag you have already pulled).
System prompt, temperature, output tokens, timeout
- What to Enter:
- Optional fields for tuning agent behavior β leave at defaults unless you have a specific reason to change them.
All configuration lives under Joplin Settings β "Joplin AI Agent." Because the plugin speaks a generic OpenAI-compatible protocol rather than calling a specific vendor SDK, any local or self-hosted server that exposes that same API shape should work by changing only the base URL.
Get Joplin AI Agent
Joplin AI Agent installs as a plugin inside Joplin, not as a standalone application β Joplin itself must already be installed. As of this review, the plugin has not been confirmed to appear in Joplin's in-app Community Plugins search, so install it manually from the .jpl file published on GitHub Releases.
Manual install from GitHub Releases (recommended)
- How to Install:
- Download
com.hugovalim.joplin-ai-agent.jplfrom the GitHub Releases page. In Joplin, open Settings β Plugins, use the "Install from file" option, and select the downloaded.jplfile. Restart Joplin if prompted, then enable the plugin if it is not already active.
Build from source
- How to Install:
- Clone github.com/HugoValim/joplin-ai-plugin and follow the repository's own build instructions β useful if you want a specific commit or plan to contribute changes.
Requires Joplin 3.6 or newer. Joplin AI Agent is desktop-only β it explicitly does not support Joplin's mobile apps, so install it only on a Windows, macOS, or Linux desktop Joplin instance.
How Does Joplin AI Agent Protect Your Notes When It Writes?
Every note or file change Joplin AI Agent proposes appears first as a temporary diff document, not a silent edit. You review the exact change before deciding whether to apply it β the agent does not overwrite a note on its own.
- Diff-first writes β a proposed change renders as a temporary diff document showing exactly what would change, before anything is applied to the real note
- Timestamp-based conflict detection β the plugin checks a note's last-modified timestamp before applying an edit, to catch cases where you or another device changed the note after the agent read it
- Undo window β up to ten runs stay recoverable for up to seven days, so an unwanted change can be reverted after the fact, not only rejected before it lands
- Anti-injection and anti-fabrication rules β per the plugin's own documentation, it applies rules aimed at preventing prompt injection carried in note content and at reducing fabricated citations when the agent references your notes
Who Should Use Joplin AI Agent?
Whether Joplin AI Agent fits depends on whether you already use Joplin as your notes app and want an AI agent that can read and, with review, edit that vault using a backend you control.
Competitors and Alternatives
Joplin AI Agent competes most directly with other AI agent plugins built for a specific notes app rather than a standalone chat interface. The closest published PromptQuorum comparison today is for a different host app.
- Copilot for Obsidian Review β a same-category AI agent plugin, but for Obsidian rather than Joplin. It shares the same core idea (an AI agent reading and editing your notes vault, with local-model support), useful for comparing how two different notes apps approach the same problem.
- Smart Connections Review β a different kind of tool for the same broader "AI inside your notes app" category: a local semantic-search and link-discovery plugin for Obsidian, not an agent that edits files.
Common Mistakes When Evaluating Joplin AI Agent
Most confusion about Joplin AI Agent comes from assuming it is an official Joplin feature, or expecting it to work the same way on mobile as on desktop.
Frequently Asked Questions
What is Joplin AI Agent?
Joplin AI Agent is a community-developed plugin for the Joplin notes app that adds an AI chat agent with tool-based read and, with review, write access to your notes, notebooks, and text files. It is built independently by developer HugoValim.
Does Joplin AI Agent work with local AI models?
Yes. It connects to any OpenAI-compatible HTTP/SSE endpoint, and its default base URL (http://localhost:11434/v1) matches Ollama's local server, so it works with a fully local model with no code changes. It also works with LM Studio or another OpenAI-compatible server by changing the base URL.
Is Joplin AI Agent made by the Joplin team?
No. It is an independent community plugin built and maintained by developer HugoValim, not developed or officially endorsed by Joplin's maintainers.
What license is Joplin AI Agent released under?
MIT, per the plugin's GitHub repository at github.com/HugoValim/joplin-ai-plugin.
How do I install Joplin AI Agent?
Download the com.hugovalim.joplin-ai-agent.jpl file from the plugin's GitHub Releases page, then in Joplin open Settings β Plugins and use "Install from file" to select it. It has not been confirmed to be searchable inside Joplin's in-app plugin marketplace, so this manual install is the documented path.
Does Joplin AI Agent work on Joplin mobile?
No. The plugin explicitly does not support Joplin mobile β it is desktop-only, for Windows, macOS, and Linux installs of Joplin.
What Joplin version does Joplin AI Agent require?
Joplin 3.6 or newer for the plugin itself. Its optional note-retrieval (RAG) search feature specifically requires Joplin 3.7 or newer.
Does Joplin AI Agent edit my notes automatically?
No. Every proposed change is shown as a temporary diff document for you to review before it is applied β the agent does not write to a note silently.
Can I undo a change Joplin AI Agent made?
Yes. The plugin retains up to ten runs for up to seven days, so a recent agent-made change can be reverted after the fact.
What AI backends does Joplin AI Agent support?
Any OpenAI-compatible HTTP/SSE endpoint, per its own documentation β this includes Ollama (the default), LM Studio, and the OpenAI API, since it uses a generic API shape rather than a vendor-specific SDK.