Claude + Obsidian: Give Claude a Memory That Never Resets

Claude + Obsidian: All You Need to Know to Build an AI-Powered Second Brain

Claude + Obsidian combines Claude Code's file-system reasoning with a local markdown vault, creating an AI assistant that remembers your context across every session through a single configuration file called CLAUDE.md. It works because Claude Code reads and writes the plain markdown files that live on your machine, so your knowledge base becomes permanent memory rather than a chat that resets. That said, it requires basic terminal comfort and a paid Claude plan, so it is not a zero-setup, no-code tool.

The gap most people feel is simple: AI tools forget everything the moment you close the tab, and note-taking apps store your thoughts but never actually think about them. You spend half your time re-explaining your projects to a chatbot, and the other half watching good notes gather digital dust. Pairing Claude with Obsidian closes that gap. Claude brings the reasoning; Obsidian brings a permanent, local, owned knowledge store. Together they build a second brain that compounds. This guide covers the setup, the CLAUDE.md configuration, memory management, MCP extensions, real workflows, honest trade-offs, and the concrete value for knowledge workers, creators, developers, and researchers. Plus, since these tools bill in USD, the smartest way to pay for them.

Paying for Claude, ChatGPT, or Gemini every month? Bleap charges 0% FX fees on your USD subscriptions and gives a flat 20% cashback on Claude, ChatGPT, and Gemini renewals, with a self-custodial Mastercard and no subscription of its own. Get the Bleap card →

1. What Claude and Claude Code Actually Are (And Why the Distinction Matters)

Claude is Anthropic's large language model, the conversational AI you access through a browser or API. It answers questions, drafts text, and reasons through problems inside a chat window.

Claude Code is the agentic, terminal-based version. It reads, writes, and edits files directly on your machine. That distinction is everything for a second-brain setup: Claude Code acts inside your file system, not just in a chat box. It can open your notes, edit them, create new ones, and reorganise folders.

On access, Claude Code has no standalone price. Claude Code has no standalone price. There are two ways to pay for it. Route one is a Claude subscription: Pro at $20/month, Max 5x at $100, Max 20x at $200, any Team seat, or Enterprise, where terminal work draws from the same usage pool as your chats. Route two is pay-as-you-go API billing.

2. The Core Problem Both Tools Are Trying to Solve

The AI Memory Problem

Every standard AI session starts from zero. No continuity, no context, no history. You re-explain your role, your projects, your preferences, and your goals every single time. It is like hiring a brilliant assistant with amnesia who resets overnight.

The Note-Taking Trap

Obsidian on its own stores information beautifully but does not analyse, synthesise, or act on it. Notes without intelligence are a digital filing cabinet, not a thinking partner. You capture everything and still struggle to connect the dots.

Why the Combination Fixes Both

Claude supplies the reasoning layer. Obsidian supplies the persistent memory layer. Together they create a system that learns and grows alongside you, one that gets more useful the longer you use it rather than resetting every session.

3. Why Obsidian Is the Right Pairing for Claude

Local-First, Markdown-Native Architecture

Your files live on your machine, so Claude Code reads and writes them directly, no API bridge required. Plain markdown is natively understood by language models, so there is zero conversion overhead. What you write is exactly what Claude reads.

Vault Structure as a Knowledge Graph

Obsidian's folder and link structure maps naturally to project-based AI context. Backlinks and tags become a routing layer that lets Claude navigate your knowledge base intelligently, following connections the way you do.

Ownership and Privacy

There is no vendor lock-in. Your knowledge base is portable and fully owned. Because storage is local, sensitive business or personal data never leaves your machine by default. That matters if you handle client work, research, or anything you would not want sitting on a third-party server.

4. How to Set Up the Claude + Obsidian Integration (Step-by-Step)

Prerequisites

You need Node.js installed and an Anthropic account with either API access or a Claude Code subscription. You also need an existing Obsidian vault, or a fresh one created for this purpose.

Installing Claude Code

Install via npm:

npm install -g @anthropic-ai/claude-code

Then authenticate with your Anthropic API key or subscription login.

Launching Claude Code Inside Your Vault

Navigate to your vault directory in the terminal:

cd /path/to/your/vault

Run claude to open an agentic session rooted in your vault. Claude Code now has read and write access to every markdown file inside it.

First-Run Checklist

Verify Claude can list and open files. Create a /claude/ subfolder as the dedicated AI workspace. Confirm no sensitive files are inadvertently exposed before you go further.

5. CLAUDE.md: The Configuration File That Acts as Your AI's Brain

What CLAUDE.md Is

CLAUDE.md is a plain markdown file placed at the root of your vault or project folder. Claude Code reads it automatically at the start of every session, giving you persistent context without re-prompting.

What to Put in CLAUDE.md

• Identity block: who you are, your role, your goals, and your preferred communication style.
• Project index: active projects, key stakeholders, and ongoing threads.
• Rules and preferences: tone guidelines, output formats, and things Claude should never do.
• Vault map: an explanation of your folder structure so Claude navigates efficiently.

Why It Is the "Brain of the Brain"

Every session inherits your full context automatically, so you never re-explain yourself. Changes to CLAUDE.md are reflected immediately in Claude's next session. Treat it as a living document and update it as your work evolves. A well-maintained CLAUDE.md is the single biggest lever on output quality.

6. Memory and Context Management: The Compounding Knowledge Effect

memory.md and Session Logs

Create a memory.md file that Claude updates at the end of each session with key decisions, open loops, and insights. These session logs give you a searchable audit trail of your AI-assisted thinking.

How Knowledge Compounds Over Time

Each session builds on the ones before it rather than starting cold. Patterns, preferences, and project knowledge accumulate, so your AI genuinely becomes more useful the longer you use it. This is the compounding effect that a browser chatbot can never match.

Structuring Notes for AI Readability

Use consistent frontmatter (title, date, tags, status) so Claude can query and filter notes. Avoid deeply nested prose; bullet structures and clear headers improve Claude's parsing accuracy considerably.

Building a system that pays off more every week? Make your tools do the same. Claude Pro runs $20/month billed in USD. Pay with Bleap for 0% FX fees and a flat 20% cashback on your Claude subscription, so your AI stack costs less every renewal. Get the Bleap card →

7. MCP: Connecting Claude to External Tools and Data Sources

What Model Context Protocol (MCP) Is

MCP is an open standard from Anthropic that lets Claude connect to external services through standardised plugins. Think of MCP servers as tool extensions that give Claude capabilities beyond reading files.

Practical MCP Extensions for Obsidian Workflows

• Web search MCP: pull live research directly into vault notes.
• Calendar and task MCP: link Claude to your schedule and to-do system.
• Database MCP: query Notion, Airtable, or SQLite from within a Claude session.

You install and register an MCP server in the Claude Code config, and it becomes available to every session.

When to Use MCP vs. Native Vault Files

Use MCP when the data lives outside Obsidian. Use vault files when ownership and offline access matter most. The two are complementary, not competing.

8. Real Use Cases and Workflows That Deliver Immediate Value

Knowledge Management and Research Synthesis

Ask Claude to synthesise notes from a research folder into a structured briefing. It identifies contradictions, gaps, and connections across dozens of notes in seconds, work that would take you an afternoon.

Content Creation Pipeline

Draft articles using your own notes as source material, with Claude maintaining your voice and style from CLAUDE.md. Repurpose long-form notes into LinkedIn posts, newsletters, or scripts without losing your tone.

Task and Project Management

Claude reads project notes and surfaces overdue tasks, blocked items, and next actions. It can generate weekly review summaries automatically from your session logs.

Personal CRM and Relationship Tracking

Store meeting notes in a /people/ folder, and Claude cross-references contacts and flags follow-ups so no relationship slips through the cracks.

9. Skills and Slash Command Automation: Building Reusable Workflows

Skills in Claude Code are saved prompt templates stored as markdown files in /claude/skills/. Build ones like weekly-review.md, article-draft.md, and meeting-summary.md. Slash commands let you invoke a skill in one line instead of writing a full prompt each time. The payoff is a productivity multiplier: standardised workflows produce consistent, high-quality outputs across every session, so you stop reinventing the same prompt over and over.

10. Cost, Value, and How Claude Compares to Alternatives

Pricing Overview

For heavy, daily use, a subscription is usually the better value. Claude's consumer plans are Free ($0), Pro $20/mo (or $17/mo billed annually, $200 upfront), Max at $100/mo (5x Pro) and $200/mo (20x Pro), Team at $25/seat/mo (Standard) and $125/seat/mo (Premium), and Enterprise at custom pricing. For lighter, bursty use, pay-as-you-go API billing can cost less. According to Anthropic's own data (March 2026), the average developer spends approximately $6 per day on Claude Code, with 90% of users staying below $12 per day.

Comparison to Other AI Knowledge Tools

Notion AI is integrated but locked to Notion's ecosystem with no local file ownership. ChatGPT's browser-based memory is shallow and non-transferable. Mem.ai and Reflect are purpose-built AI note apps but limited on agentic capability. Claude + Obsidian wins on ownership, depth of context, agentic file manipulation, and extensibility.

ROI Framing

The return shows up in time saved each week on research synthesis, drafting, and task management. And it compounds: the value increases as your vault grows, because more context means better outputs.

11. Honest Assessment: Pros, Cons, and Real Limitations

What Works Exceptionally Well

Persistent, compounding context. Deep file-system access. Markdown-native reasoning that needs no conversion.

Genuine Limitations to Know Before You Start

Setup requires comfort with the terminal and CLI, so it is not a no-code tool. API costs can escalate with large vaults or frequent heavy sessions. CLAUDE.md needs ongoing discipline; a neglected config file produces worse results. And it is not a replacement for a structured database when relational queries genuinely matter.

Who This Is (and Isn't) For

Ideal for developers, researchers, writers, consultants, and systems thinkers. Less ideal for anyone who wants a fully GUI-based, zero-maintenance assistant with no setup at all.

12. How to Extract Real Business and Day-to-Day Value

• Individual knowledge workers: turn scattered research into publishable outputs faster.
• Content creators: build a proprietary content engine trained on your own ideas.
• Consultants and freelancers: maintain client context across engagements without losing the thread.
• Small teams: share a vault with shared CLAUDE.md conventions for consistent AI-assisted output.

The mindset shift required is to treat the vault as infrastructure, not just a note dump. Commit to the daily habit: open Claude in your vault every working day, and the returns compound.

Your knowledge base compounds. Your AI spend does not have to grow with it. Bleap gives 0% FX fees on USD-billed AI subscriptions and a flat 20% cashback on Claude, ChatGPT, and Gemini, with no monthly subscription of its own. Get the Bleap card →

Frequently Asked Questions

Do I need coding skills to set up Claude + Obsidian integration?

Basic terminal familiarity is required to install Claude Code and navigate to your vault directory. No programming experience is necessary beyond that.

What is CLAUDE.md and why is it important for Obsidian AI workflows?

CLAUDE.md is a configuration file Claude Code reads automatically at session start. It gives Claude persistent context about who you are, your projects, and your preferences, eliminating the need to re-explain yourself every session.

How does Claude Code's MCP feature work with Obsidian?

Model Context Protocol lets Claude connect to external tools such as search, calendars, and databases through plugin servers. This extends Claude's reach beyond your vault to pull in live data without leaving the session.

Is the Claude + Obsidian setup more powerful than ChatGPT for knowledge management?

For local, compounding, file-based knowledge management, yes. Claude Code's direct file-system access and CLAUDE.md persistence provide deeper, more reliable context than ChatGPT's browser-based memory.

Can I use Claude with Obsidian without paying for the API?

A Claude subscription such as Pro supports agentic features including Claude Code. Yes, the $20 Pro plan includes Claude Code. Anthropic's pricing page lists "Includes Claude Code" on Pro, which costs $17/month billed annually or $20 month-to-month. Alternatively, you can point Claude Code at an API key with token-based billing.

How do I prevent Claude from accessing sensitive files in my Obsidian vault?

Structure sensitive files in a dedicated subfolder and use a .claudeignore file (similar to .gitignore) to explicitly exclude directories from Claude Code's file access scope.

Conclusion: Why Claude + Obsidian Is the AI Knowledge Setup Worth Building

The core value is simple: AI reasoning paired with permanent, owned, local knowledge. The compounding advantage is real, because the system becomes more valuable with every session you run. Getting started is easier than it looks: install Claude Code, point it at your vault, and create CLAUDE.md. The people who benefit most are those who treat their vault as a living, evolving asset. Start with one workflow, a weekly review or research synthesis, and expand from there.

One last practical tip. Whichever AI tools power your second brain, pay smart. With Bleap you skip the FX fees on USD subscriptions, and on Claude, ChatGPT, and Gemini you earn 20% cashback on every renewal, on a self-custodial Mastercard with no monthly subscription.