CallosiumCALLOSIUM
callosium / learn / how to connect your obsidian vault to any ai

How to Connect Your Obsidian Vault to Any AI

Your Obsidian vault is already plain Markdown files sitting in a folder on your computer, so there is nothing to convert. To connect it to any AI, you point a local-first memory tool like Callosium at that folder, and Claude, ChatGPT, and Cursor can all read your notes. You choose which folders each AI sees, and with the free version the files never leave your machine.

That is the whole idea. Teach one AI something, and because they all read the same vault, every AI knows it. Below is exactly how the connection works, how per-folder scoping keeps your private notes private, and what to expect when early access opens.

Why your Obsidian vault is already AI-ready

An Obsidian vault is not a locked database or a special file format. It is a folder full of plain Markdown notes, the same files you already write and link every day. That matters because most AI memory lives trapped inside one app, in a format you cannot open or move. Your vault is the opposite. It is already readable text on your own disk.

So connecting Obsidian to AI is not an import job. There is no export, no upload to a cloud service, no plugin that rewrites your notes. You simply give an AI permission to read the folder that is already there. This is why an Obsidian second brain is the easiest kind of knowledge to hand an AI: the hard part, writing things down in clean text, is already done. If you are new to the idea, here is what a second brain is and why your AI needs one.

The one-time setup, step by step

Here is the whole process, start to finish. It is a one-time setup per AI, and none of it touches the contents of your notes.

  1. Install a local-first memory tool. Callosium runs on your own computer and speaks the connection standard (MCP) that modern AI apps use to read outside files.
  2. Point it at your vault folder. This is the same folder Obsidian already opens, so there is nothing new to organize.
  3. Connect your AI. In Claude Desktop, Claude Code, Cursor, or any tool that supports connected apps, add Callosium as a connected memory. The team wrote setup notes for the 23 most common apps (Claude, Cursor, Windsurf, VS Code, Zed, and more), so it is one short guide per app, not a research project.
  4. Choose which folders that AI can see (more on this below).
  5. Ask your AI something from your notes. It reads the relevant Markdown and answers.

That is it. Do the same short steps to give ChatGPT memory or to make Claude remember your work, and they all read the same vault.

Per-folder scoping: you choose what each AI sees

Here is the feature that makes this safe to actually use. You almost certainly do not want every AI reading your entire vault. Your journal, your finances, your half-formed ideas: those are not for a coding assistant.

Callosium gives each AI its own view. You grant Cursor your project notes and nothing else. You give Claude your research folder. You keep your private daily notes out of all of them. This is per-agent folder scoping, and it is enforced by the software, not by a promise in a settings page. An AI cannot read a folder you did not grant it, full stop.

It also runs the other way. Every change an AI makes to your notes is stamped with who made it, you or a specific AI, and that signature cannot be faked. So you always know whether a line came from you or from ChatGPT.

Is this private? What actually leaves your computer

The honest answer most people want: with the free version, nothing gets uploaded. Your Markdown files are never sent anywhere by Callosium. The reading happens locally, on your machine, and the files stay exactly where Obsidian keeps them. Nothing is sold, and nothing is mined.

This is what local-first means in practice. When you ask a question, the tool finds the relevant notes on your disk and passes only what is needed into your AI, instead of shipping your whole vault to anyone. If you later want the same notes on your phone and your laptop, paid tiers can sync through your own cloud account, but you never need a paid tier to keep or read your data. The core stays free. Want the wider view? Here are the best local-first AI memory tools compared.

Obsidian AI plugins, MCP servers, and built-in memory: the honest comparison

If you have searched for an Obsidian AI plugin or an Obsidian MCP server, you have probably found community projects that wire a single AI to your vault. They can work, but they are do-it-yourself duct tape: no official server, no per-folder scoping, and you rebuild the whole thing for every new AI you add.

Built-in memory in ChatGPT or Claude is the other common route. It is free and needs zero setup, but it is siloed inside one vendor, you cannot open or export it, and it disappears if you switch tools or cancel. This is not hypothetical. One of the best-funded AI memory products was acquired this year and started shutting down, with apps discontinued and accounts scheduled for deletion. Memory you rent can be switched off. Memory that lives in your own Obsidian folder cannot. This is the heart of who really owns your AI memory, and it is worth understanding before you pour years of notes into a vendor silo. For a direct look, see Callosium vs ChatGPT memory.

What it costs and when you can start

Callosium's core engine is open source (Apache-2.0) and on GitHub from day one. The free version is free forever, and it is the full local experience, not a trial. Paid tiers only add convenience, like syncing across your own devices through your own cloud. You never need to pay to keep your data, because the data was always just your own Markdown files.

Early access opens on 4 August 2026 at callosium.com. If you already keep an Obsidian vault, you are the ideal starting point: your notes are clean text, already organized, already yours. The only thing left is to let every AI read them. For the bigger picture, here is how to build a second brain every AI can read.

Frequently asked questions

Do I need to change how my Obsidian vault is organized?
No. Your vault is already plain Markdown in a folder, which is exactly what the tool reads. You point Callosium at the same folder Obsidian opens and keep your existing structure. There is nothing to convert, export, or reformat.
Which AIs can read my vault?
Claude (Desktop and Code), ChatGPT, Cursor, and most AI tools that support connected apps or MCP. The team researched the 23 most common clients (including Windsurf, VS Code, Zed, Cline, Continue, JetBrains, Warp, LM Studio, Jan, and Goose), so there is one short setup guide per app.
Will connecting my vault upload my notes to the cloud?
No. With the free version, your Markdown files are never uploaded anywhere by Callosium. The reading happens locally on your own computer, and only the notes needed to answer a question are passed into your AI. Nothing is sold.
Does it work in languages other than English?
Yes. Callosium handles English and Arabic at parity, tested to the same benchmark bar, using an on-device multilingual model. If Arabic matters to you, here is more on an AI that works in Arabic.
Is it accurate enough to trust with my notes?
It was tested on a fresh 15,000-question benchmark and answered about 19 out of 20 correctly, with a median answer time around 28 milliseconds. Just as important, when the answer is not in your notes it says so instead of guessing. See how we tested it on 15,000 questions.
Can I use the same vault across more than one computer?
Yes. The free version reads your vault locally on each machine, and paid tiers add optional syncing through your own cloud account so your phone and laptop stay in step. You never need a paid tier to keep or read your data.
One brain, every AI, your files.

If your second brain already lives in Obsidian, Callosium lets every AI read it from one folder, privately, with early access opening 4 August 2026.

Get early access