Inter-office memo
- To
- Everyone who wants Claude Code to work in their Obsidian vault
- From
- Mo, Chief Executive
- Date
- November 17, 2026, 7:40 PM CST
- Re
- Claude Code and Obsidian
How to use Claude Code with Obsidian in 2026: 7 ways compared
Run Claude Code in your vault’s folder with a CLAUDE.md, and it edits your notes as they are, on a Claude plan from $20 a month. To stay inside Obsidian, use the free Claudian, Copilot for Obsidian or Agent Client plugin; Claude Cowork suits research with no terminal, and Enjoy suits working on your vault from your phone with every lab’s agent.
Disclosure: Enjoy is our product, and it runs Claude Code. We checked every way below against its maker’s own pages on November 17, 2026, and we say where another way is the better pick, including the free ones that don’t need Enjoy.
The ways to use Claude Code with Obsidian, compared
Obsidian doesn’t need a special connection to work with an agent. Its help center says “Obsidian stores your notes as Markdown-formatted plain text files in a vault. A vault is a folder on your local file system, including any subfolders,” and “Obsidian automatically refreshes your vault to keep up with any external changes.” Claude Code works on folders of files, so it can already read, search, edit and reorganize your notes. The choice is where you talk to it, and what else you want: a sidebar in Obsidian, other agents, Obsidian’s own search, or your phone.
| Way | Best for | Price, checked November 17, 2026 | Where you use it | From your phone | Agents |
|---|---|---|---|---|---|
| Claude Code in your vault | The simplest setup, at no extra cost | Included in Claude Pro ($20 a month), Max ($100) and Ultra ($200) | A terminal, or the Claude app’s Code tab | Remote Control, while your computer runs the session | Claude Code |
| Claudian | Staying in Obsidian, with edits made right in your notes | Free, open source | A sidebar in Obsidian | No, desktop only | Claude Code, Codex, Grok Build, Antigravity CLI, OpenCode, Pi, DeepSeek Harness |
| Copilot for Obsidian | One plugin for chat, search and an agent | Free with your own agent; Plus $14.99 a month | A sidebar in Obsidian | Quick Chat only; the agent is desktop only | OpenCode, Claude Code, Codex |
| Agent Client | The most agents, side by side, in tabs or in a note | Free, open source | Sidebar, tabs, floating windows or a note | No, desktop only | 11 presets, from Claude Code and Codex to Gemini CLI and Kiro, and any ACP agent |
| The Obsidian CLI or an MCP server | Giving any of these Obsidian’s search, backlinks and daily notes | Free | Alongside one of the others, with Obsidian running | Through whichever you pair it with | Any agent that runs commands or takes MCP servers |
| Claude Cowork | Research and documents from your notes, with no terminal | Included in the same Claude plans | The Claude app, on any device | Yes; local folders while the desktop app is open | Claude |
| Enjoy | Your vault from your phone, with every lab’s agent | A monthly subscription, free for 7 days, with your phone and one computer (pricing) | Enjoy’s app, on your computer, phone or browser | iPhone app and any browser, while your computer is on | Claude Code, Codex, Grok Build, Antigravity, Muse Code, OpenCode |
Prices are per month as each maker lists them in the US, before tax. Obsidian itself is free, and its pricing page says you’re “not required to pay for a commercial license.” Every way here that runs Claude does it on your own Claude plan, which Anthropic bills for separately, and Claude Code isn’t on its Free plan.
Before you start: give your vault a CLAUDE.md
Whichever way you run Claude Code, a CLAUDE.md file at the top of your vault tells it how the vault works. Claude Code’s memory docs say “CLAUDE.md files are markdown files that give Claude persistent instructions for a project,” and “Claude reads them at the start of every session.” Use it to say what each folder is for, how you name notes, which tags and templates you use, and what to leave alone, such as the .obsidian settings folder.
If you also use Codex or another agent, write an AGENTS.md instead: Claude Code “can read AGENTS.md as your project instructions,” and does when there’s no CLAUDE.md. Running /init in Claude Code writes a first draft for you.
Agents change files directly. Before you ask one to rename, merge or move notes in bulk, keep a backup or put the vault in Git, and try the job on one folder first.
Claude Code, in your vault’s folder
Best for: the simplest setup, with nothing to install but Claude Code.
Open a terminal in your vault’s folder and run claude, or use the Code tab in Anthropic’s desktop app, where you “click the project folder control, next to the environment selector, to choose the folder Claude works in.” The desktop app runs on Mac and Windows, with Linux in beta. Claude Code then reads and edits your notes like any other files, and Obsidian picks up the changes.
To reach the same session from your phone, Remote Control “connects claude.ai/code or the Claude app for iOS and Android to a Claude Code session running on your machine.” It’s available “on Pro, Max, Ultra, Team, and Enterprise plans. API keys are not supported.”
Price: included in Claude Pro at $20 a month, or $17 billed yearly ($200 up front), Max at $100 and Ultra at $200, according to Anthropic’s pricing. It isn’t in Free.
Watch for: it works on your files, not in Obsidian, so it doesn’t know which note you have open unless you name it. Remote Control needs the session to keep running on your computer: “When you stop claude remote-control with Ctrl+C, the sessions it was serving stop responding from your phone or browser.”
Claudian
Best for: staying in Obsidian, with the agent’s edits made and shown right in your notes.
Claudian is “An Obsidian plugin that embeds AI coding agents (Claude Code, Codex, Grok Build, Antigravity CLI, OpenCode, Pi, DeepSeek Harness, and more to come) in your vault. Your vault becomes the agent’s working directory.” It has about 2.7 million downloads in Obsidian’s plugin directory and 16,000 stars on GitHub, and version 2.3.44 came out on November 16, 2026. You talk to the agent in a sidebar, type @ to point it at notes and folders, run your slash commands and skills, and use Inline Edit to change a selection “directly in notes with word-level diff preview.” Its Projects give several sessions shared instructions and a memory file.
Price: free and open source, under the MIT license. You install the agent yourself and need “A compatible subscription or API provider,” such as a Claude plan for Claude Code.
Watch for: it’s “Desktop only (macOS, Linux, Windows)” and needs “Obsidian v1.13.0+.” It doesn’t help on your phone.
Copilot for Obsidian
Best for: one AI plugin for chat, search and an agent, with hosted models if you want them.
Copilot for Obsidian, from Brevilabs, describes itself as “Run agents in Obsidian - OpenCode, Codex, Claude Code etc.” Its README recommends OpenCode, and for Claude Code you “Connect an existing installation. Copilot detects common install locations and uses your Claude Code login.” It adds skills shared across agents, including “skills for Obsidian Markdown, Bases, Canvas, and the Obsidian CLI,” saved commands, and a Quick Ask that works on a selection. It has about 3.7 million downloads in Obsidian’s plugin directory, the most of the plugins here, and 8,000 stars on GitHub.
Price: “The Copilot plugin is open source and works without a Copilot license when you use your own agent account, provider key, or local model.” Plus, $14.99 a month or $139.99 a year, adds Copilot-hosted models and cloud tools, and “Multi-agent requires active Plus access.”
Watch for: “Agent is a desktop feature because its backends run local processes. Quick Chat, custom Commands, and Quick Ask remain available on mobile.” Hosted features go through Brevilabs: “Copilot-hosted models and hosted features send the required input to Brevilabs for processing.”
Agent Client
Best for: the widest choice of agents inside Obsidian, several at once.
Agent Client brings “AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.” It has 11 presets, from Claude Code and Codex to Gemini CLI, Kiro and Antigravity CLI, “plus any ACP-compatible agent as a custom entry.” You can “Run several agents at once — in sidebar tabs, editor tabs, or floating windows,” broadcast one prompt to all of them, or “Embed a live chat inside any note.” It tells agents “to reply with [[wikilinks]],” and shows their edits as word-level diffs.
Price: free and open source, under the Apache 2.0 license. It has about 340,000 downloads in Obsidian’s plugin directory, and version 0.13.2 came out on November 15, 2026.
Watch for: “Agent Client is a desktop-only plugin,” and “the agents themselves have the same full system access they have in a terminal.” Approving each action is on by default; Auto-allow permissions turns that off.
The Obsidian CLI, or an MCP server
Best for: giving whichever agent you use Obsidian’s own search, backlinks and daily notes, not only its files.
The Obsidian CLI “lets you control Obsidian from your terminal,” and “Anything you can do in Obsidian you can do from the command line.” An agent that runs commands, like Claude Code, can use it: obsidian search query="meeting notes", obsidian daily:append content="- [ ] Buy groceries", backlinks and orphans among them. Turn on Command line interface in Settings → General; it needs Obsidian’s 1.12.7 installer or later. Mention it in your CLAUDE.md so the agent knows to use it.
For agents that take MCP servers, the Local REST API plugin gives “AI agents a direct line into your Obsidian vault via a secure, authenticated REST API,” and a built-in MCP server that can search notes by their frontmatter, tags and paths.
Price: free.
Watch for: “Obsidian CLI requires the Obsidian app to be running,” and the REST API is a plugin, so it runs only while Obsidian does. Check that an MCP server is still maintained before you install it: MCP Tools for Obsidian, once a popular choice, is archived.
Claude Cowork
Best for: research, summaries and documents from your notes, with no terminal, from any device.
“Claude Cowork uses the same agentic architecture that powers Claude Code, with no terminal required,” says Anthropic’s getting-started guide. “On desktop, Claude can read from and write to your local files without manual uploads or downloads,” in “folders you’ve connected,” so you can connect your vault. It can also run tasks on a schedule, such as a weekly review of your notes.
Price: included in every paid Claude plan: Pro, Max, Ultra, Team and Enterprise.
Watch for: “On Pro, Max, and Ultra plans, new sessions run in the cloud on every surface,” and your folders are reached “through the desktop app, and only while it’s open.” A scheduled task that uses a folder “runs only while your computer is awake and Claude Desktop is open.” Each task uses “more of your usage than a quick question.”
Enjoy
Best for: working on your vault from your phone, with Claude Code and other labs’ agents, and on a schedule.
Enjoy is a desktop app for Mac, Windows and Linux that runs Claude Code, Codex, Grok Build, Antigravity, Muse Code and local models through OpenCode, on the plans you already have. Your vault opens as a project with Open any folder: “Any folder on your computer can be a project, whether it’s an app you started with another tool, a website you downloaded, or a folder of documents,” and “Opening it in Enjoy doesn’t move or change your files.” Enjoy keeps its conversations and workflows in its own storage, outside the vault. Then:
- Your vault from your phone. The iPhone app and the web app run agents on the vault on your computer, and you can open and edit your notes in either.
- Every lab’s agent. Ask Claude Code, then switch to Codex or another agent in the same conversation, or keep going on another account when one runs out of usage.
- Workflows on a schedule. A workflow can, say, summarize yesterday’s daily notes every weekday at 8:00.
- Your skills. Type / to run one of Claude Code’s skills, including the ones in your vault’s
.claude/skillsfolder.
Price: Enjoy is one monthly subscription, and the first seven days are free, with a card to start. It includes your phone and any browser and one computer; each other computer costs extra. See pricing.
Watch for: Enjoy isn’t open source, it’s a monthly subscription on top of your Claude plan once the free week ends, and it isn’t inside Obsidian: links, graph and plugins stay there. Its Markdown view opens a note with metadata at the top, such as Obsidian’s properties, as Markdown source rather than formatted. Your phone reaches the vault only while your computer is on, and scheduled workflows run only while it’s awake with Enjoy open.
When the terminal is enough
If you already use Claude Code, start by running it in your vault with a CLAUDE.md, and add the Obsidian CLI if you want it to use Obsidian’s search and links. That’s free on top of your plan. The plugins run the same agent, in Obsidian’s window, with conveniences around it. Choose one when you want to see each edit beside the note: Claudian for edits right in your notes, Agent Client for the most agents or several at once, Copilot if you also want its chat and search, or its hosted models. Choose Cowork if you’d rather not touch a terminal and your work is mostly research and writing, and Enjoy if you want your phone, other labs’ agents and schedules in one place.
How we compared
We read each maker’s own docs, READMEs and pricing pages on November 17, 2026, and every one is linked below. Download counts, GitHub stars and versions are as of that day. We quote their own words for the limits, and we don’t count features a maker hasn’t documented. These plugins change weekly, so we recheck this guide against its sources at least once a month, and the date at the foot of the page says when we last did.
12.Questions.
Can Claude Code work with Obsidian?
- Yes. An Obsidian vault is a folder of Markdown files, so Claude Code can read, search and edit it like any project folder. Open a terminal in the vault and run `claude`, or choose the vault as the folder in the Claude app’s Code tab. Plugins such as Claudian put it in a sidebar inside Obsidian, and the Obsidian CLI lets it use Obsidian’s own search, backlinks and daily notes.
What’s the best Obsidian plugin for Claude Code?
- It depends on what else you want. Claudian runs Claude Code and six other agents in a sidebar and edits right in your notes; Copilot for Obsidian, the most downloaded of the three, adds chat, search and its own hosted models if you pay for Plus; Agent Client runs any agent that speaks the Agent Client Protocol, several at once. All three are free, open source and desktop only.
Is there a free way to use Claude Code with Obsidian?
- The plugins and the Obsidian CLI are free, and Obsidian doesn’t require a license even for work, but Claude Code isn’t free. Anthropic includes it in Pro ($20 a month, or $17 billed yearly), Max ($100) and Ultra ($200), not in Free. For no AI plan at all, Copilot for Obsidian’s agent can run OpenCode with a local model or your own API key.
Can I use Claude Code on my Obsidian vault from my phone?
- Not through Obsidian’s mobile app, because Claudian, Agent Client and Copilot’s agent are desktop only. Claude Code’s Remote Control continues a session running on your computer from the Claude app, Claude Cowork reaches a connected folder while its desktop app is open, and Enjoy’s iPhone app and web app run agents in the vault on your computer, which has to be on.
Does my vault need a CLAUDE.md?
- No, but it helps. Claude Code reads CLAUDE.md files “at the start of every session,” so one at the top of your vault is the place to explain your folders, tags and templates. If you also use Codex or another agent, an AGENTS.md works too; Claude Code reads it when there’s no CLAUDE.md.