01What is Obsidian with Claude Code?

Obsidian with Claude Code lets you bring an AI agent directly into your Obsidian notes. You see your notes on the left and a Claude Code chat on the right, all inside Obsidian. This plugin is called Agent Client Protocol, and it is free.

With this setup, you can read your notes, write new ones, and organize your knowledge using AI. The agent can pull context from your entire database and help you update it. That way, your Obsidian vault becomes a living second brain.

02Main Features of the Agent Client Plugin

The plugin adds a chat panel on the right side of Obsidian. This panel connects to Claude Code, so you can ask questions or give commands. You can also use it to read your notes, write new sections, and tag pages.

  • Read your notes to get quick summaries or reference material.
  • Write new content like guides or sections, and save them as Markdown files.
  • Organize your knowledge with the Graph View and timelapse animation.
  • Link to other AI tools like Hermes or OpenClaude to share your knowledge base.

The agent uses tools inside Claude Code, so it can perform both reading and writing tasks. This makes your notes more interactive and easier to manage.

03How to Set Up Obsidian and Claude Code

Follow these steps to connect Obsidian with Claude Code. Julian Goldie walks through the entire process in the episode.

  1. Install the BRAT plugin in Obsidian through Settings > Community Plugins > Browse.
  2. Add the Agent Client Protocol plugin via BRAT by pasting the repository URL and enabling it.
  3. Install Claude Code and the ACP adapter. Run 'which claude-agent-acp' in your terminal to find the path.
  4. Install Agent MCP and authenticate by typing 'claude' in the terminal and trusting the folder.
  5. In Obsidian, go to Settings > Agent Client > Built-in Agents, and enter the path you found from the terminal.
  6. Select the correct folder, not auto-detect, from the two paths you get back.
  7. Choose Claude Code ACP from the dropdown, and you are ready.

04Using Claude Code Inside Obsidian

Once set up, look for the robot icon in the bottom left of Obsidian. Click it to open the Agent Client panel. Now you can chat with Claude right next to your notes.

For example, you can ask Claude to write a new section on improving conversion rates. The agent will create that content as a Markdown file and save it to your vault. You can also switch between notes and tag pages while the agent watches.

You can read your notes for reference during chats. This helps you get accurate answers based on your own knowledge base. The agent can also help you organize your files into a knowledge graph, which you can view with the Graph View and timelapse animation.

05Real Test Results from the Episode

Julian tested the setup live. He used the Agent Client to generate a guide on improving conversion rates. The plugin wrote the new section and placed it in his notes.

He also demonstrated reading existing notes from his wiki during a chat. The graph view shows how notes become more connected over time. After using the timelapse animation, the files arranged into a clear knowledge graph, showing better organization.

This real example proves the workflow: you can improve your notes with the agent, and the agent learns from your notes for future tasks.

06Tips, Limits, and Mistakes to Avoid

One common mistake is seeing 'command not found' when opening the chat. To fix it, run 'which claude-agent-acp' in the terminal and paste the correct path into the settings. Do not rely on auto-detect.

Make sure to select the right folder from the two paths returned, not just any. Julian used the specific one he highlighted. Always choose Claude Code ACP from the dropdown.

  • Keep your Obsidian and plugins updated to avoid compatibility issues.
  • Use 'Always Allow' when you want the agent to act without asking every time.
  • Start with small tasks like writing a single note before scaling up.

Be aware that this setup is for technical users. You need to be comfortable with terminal commands and settings panels.

07Who Should Use Obsidian with Claude Code

This tool is great for anyone who uses Obsidian as a knowledge base and wants AI help. It is especially useful for content creators and marketers who manage a lot of notes and guides.

Julian uses it to keep a wiki of his information for AI agents across Hermes, OpenClaude, and Claude Code. You can do the same by linking your Obsidian notes to those tools, so they always have current context.

If you write tutorials, track research, or build personal knowledge systems, this setup helps you work faster. It turns your notes into a live asset that improves with use.