Docs / ModelBrain plugin for Obsidian

The ModelBrain plugin for Obsidian

The plugin puts ModelBrain inside Obsidian. One search covers your notes and everything your AI assistants have been told to remember, and a selection in a note can be saved as a memory that Claude, ChatGPT and Cursor all recall. It is free, open source and desktop only, and it needs the ModelBrain app.

View it in Obsidian's plugin directory →

You may not need it

ModelBrain already reads an Obsidian vault as a folder. Add the vault once and your assistants can answer from your notes, with or without this plugin. That setup is in Use ModelBrain with an Obsidian vault.

Install the plugin if you want to search and save from inside Obsidian instead of from an assistant.

Install
  1. Install ModelBrain and start it once. See the install guide. The plugin does nothing without the app.
  2. In Obsidian, open Settings, then Community plugins, then Browse. Search for ModelBrain, choose Install, then Enable. It needs Obsidian 1.13 or later on macOS, Windows or Linux.
  3. Open the plugin's settings. Status should read Connected. If ModelBrain asks whether to allow Obsidian, choose Allow.
  4. Connect the vault, if it is not already. Open the ModelBrain menu, choose Add Vault, and pick the vault's folder. ModelBrain only adds a folder that you choose yourself, so the plugin cannot do this step for you. Its settings show which folder to pick.
What it does
Feature
Where
What happens
Search panel
Ribbon icon, or the command "Open search"
Searches your notes and saved memories together. A result from this vault opens the note. A filter narrows it to this vault or to saved memories.
Remember selection
Command palette or right-click menu
Saves the selected text as a memory, with the note's path, so any connected assistant can recall it.
Related memories
Command "Show memories related to this note"
Lists what your assistants already know that touches the open note.
Status
The plugin's settings tab
Shows whether ModelBrain is running, its version, and whether this vault is connected.

It never changes, creates or deletes a note.

Privacy, and the labels in Obsidian's directory

Obsidian's automatic review labels this plugin with one warning: it runs outside programs. That is accurate. The plugin starts the two helper programs that the ModelBrain app installed, because ModelBrain is a separate app and those programs are how it talks to it. That is the only thing it does outside the vault. Since version 0.1.2 it no longer reads the disk to find them, so the earlier file access warning is gone.

It makes no network requests, has no telemetry and does not use the clipboard. What it sends to ModelBrain, on your own computer, is the text you search for, the text you choose to save with the note's path, and, for related memories, the open note's title and about its first 400 characters.

The source is public under the MIT licence at github.com/ModelBrain/modelbrain-obsidian. Obsidian's review rebuilt version 0.1.2 from that source and got the released file byte for byte, and each release file carries a GitHub build attestation that shows it was built from the public source. The ModelBrain app itself is closed source; what it does with your notes is on the privacy page.

What is tested

Version 0.1.1 was run on November 10, 2026 in Obsidian 1.15.0 on macOS against ModelBrain 0.9.2: search, opening a note from a result, saving a selection, related memories and the status tab all worked. Version 0.1.2 was checked the same way on the same day: the panel found the app and a search returned vault notes and saved memories.

It has not yet been run on Windows or Linux. If it fails there, write to hello@modelbrain.net or open an issue on GitHub.

Questions

Do I need the plugin to use ModelBrain with Obsidian?

No. ModelBrain reads the vault folder directly, so Claude, ChatGPT and Cursor can answer from your notes without it. The plugin adds a search panel and a save command inside Obsidian.

Does the plugin change my notes?

No. It never changes, creates or deletes a note. It reads the note you have open only when you ask for related memories.

Why does Obsidian's directory show a warning about running programs?

Because the plugin starts two helper programs that the ModelBrain app installed, which is how it talks to ModelBrain on your computer. It makes no network requests and has no telemetry. The source is public, and Obsidian's review rebuilt the release from it byte for byte.

Does it work on a phone or tablet?

No. It is desktop only, because it talks to a program on your computer.

No plugin needed

Add the vault folder and ask your assistant.

Obsidian guide →
Other ways to connect

Five ways to use Claude with Obsidian, and what each can change.

Read the comparison →