second-brain

Second Brain: Claude Code + Obsidian

Wire Claude Code into your second brain. Obsidian, PARA, daily notes, project archives: all editable, all queryable.

12 min read·

The Problem

Your Notes Are Passive. They Don't Have to Be.

Most people treat Obsidian as a filing cabinet. Notes go in, rarely come out, never connect to the work you're doing in Claude Code. The two systems sit side by side, completely separate, and the intelligence is lost in the gap.

What passive notes cost you

  • Re-explaining client context to Claude every single session
  • Knowledge trapped in Obsidian that Claude can never access
  • Manual copy-paste between your vault and your AI workflows
  • Meeting notes that never get processed into tasks or CRM updates

PARA

Folder Structure

Auto-Route

Inbox Processing

Persistent

Memory System

Live Sync

Obsidian Graph

Why Integrate

Claude + Obsidian Is a Force Multiplier

When Claude Code runs inside your vault, every .md file becomes both human-readable and machine-queryable. You get a second brain that actually thinks back.

Bidirectional Read/Write

Claude reads your notes to get context, then writes results back as new notes. Meeting recap lands in the client folder automatically. Graph view updates instantly.

Persistent Client Context

Every client gets a CLAUDE.md in their folder. When you work on that client, Claude reads the scoped context. No re-explaining stack, engineers, or conventions.

[[Wikilinks]] at Scale

Claude writes [[wikilinks]] between related notes. Obsidian renders them instantly in graph view. A knowledge map builds itself without any manual effort.

Compounding Memory

Session 1 you explain everything. Session 50 Claude already knows your vault structure, client names, file conventions, and preferences. Zero ramp-up time.

Architecture

How Claude Lives Inside Your Vault

Your Obsidian vault is Claude's working directory. The filesystem IS the integration: no plugins, no APIs, no sync layer.

Obsidian Vault = Claude's Working Directory

CLAUDE.md -- full identity, PARA structure, preferences

MEMORY.md -- Claude's own notes across sessions

00_Inbox/ 01_Projects/ 02_Areas/ 03_Resources/

.claude/skills/ -- read/write vault files

.claude/agents/ -- subagents for tasks

*.md files -- shared between Claude + Obsidian

[[wikilinks]] -- appear in Obsidian graph view

Claude Code Engine reads and writes both directions

External Integrations: All Flow Back as .md Files

Attio CRMGoogle CalGmailLinkedInn8nGitHub
Key insight: There is no special plugin or sync tool. Claude Code is run with cd /path/to/vault && claude. The vault becomes the working directory. Every file is instantly readable and writable.

PARA Method + Claude

Every Folder Has a Purpose. Claude Knows Each One.

PARA (Projects, Areas, Resources, Archive) gives your vault a clear grammar. Claude learns the grammar and routes everything correctly without you deciding where each file goes.

IN00_Inbox/Quick capture

Raw notes, ideas, meeting dumps, screenshots, voice memos transcribed. Everything lands here first.

What Claude Does

Reads every file daily. Extracts action items. Routes to the correct PARA folder. Creates CRM tasks. Archives processed items. Nothing stays in Inbox more than 24 hours.

P01_Projects/Time-bound initiatives

Client projects, internal builds, product launches. Each has a clear start, end, and deliverables. Structured as Clients/Active, Clients/Prospects, Internal/, Products/.

What Claude Does

Updates Progress.md with sprint logs. Appends to Communication-Log.md after meetings. Tracks blockers and unresolved items. Links related resources from 03_Resources/. Generates weekly status summaries per client.

A02_Areas/Ongoing responsibilities

Sales, Marketing, Operations, Technical, Legal. These never end. They are areas of continuous responsibility. SOPs, metrics, strategies, team docs.

What Claude Does

Maintains SOPs when processes change. Updates ICP and sales strategy docs. Generates content drafts in 02_Areas/Marketing/. Tracks operational metrics. Keeps Legal/ compliance docs current.

R03_Resources/Reference and knowledge

AI agent architectures, n8n workflows, automation patterns, tool databases, learning notes, prompt libraries. Knowledge you reference repeatedly.

What Claude Does

Builds INDEX.md files with [[wikilinks]] to connect related concepts. Finds conceptual links across files. Creates Maps of Content (MOCs). Adds TL;DR sections to research notes.

X04_Archive/Completed and inactive

Finished client engagements, deprecated SOPs, old experiments. Searchable but out of active view.

What Claude Does

Moves completed projects here automatically. Preserves all history. Searches archive when similar problems surface in active projects. Extracts patterns from past work to inform current builds.

Setup

Vault Setup: 5 Steps

No special plugins. Five configuration steps turn your existing Obsidian vault into an active intelligence layer.

1Initialize CLAUDE.md in Vault Root

Create a CLAUDE.md at the root of your vault. This tells Claude who you are, what your folder structure looks like, and how to behave.

# /your-vault/CLAUDE.md

## Who I Am
[Your identity, role, business context]

## Folder Structure (PARA)
00_Inbox/     -- quick capture
01_Projects/  -- time-bound work
02_Areas/     -- ongoing responsibilities
03_Resources/ -- reference knowledge
04_Archive/   -- completed/inactive

## How Claude Should Work With Me
- Be direct
- One step at a time when debugging
- Always explain why, not just what
2Add Path-Scoped Rules

Add rules that apply to specific parts of your vault. These are granular instructions Claude follows when working in each PARA area.

# /your-vault/.claude/rules/clients.md
---
path: 01_Projects/Clients/**
---
When working on client files:
- Always check Communication-Log.md first
- Update Progress.md when deliverables change
- Never delete client data without confirmation
- Use 4-file structure: README, Communication-Log,
  Technical, Progress
3Add Inbox Processor Skill

Create a skill that processes your inbox. This is the highest-leverage first automation. It keeps your vault clean daily with one command.

# /your-vault/.claude/skills/inbox-processor/SKILL.md

## Trigger
When user says "process inbox" or runs /inbox-processor

## Steps
1. Read every file in 00_Inbox/
2. For each file, determine category:
   - Client note → 01_Projects/Clients/Active/[match]/
   - Action item → 02_Areas/Operations/
   - Resource    → 03_Resources/[topic]/
   - Junk        → delete with confirmation
3. Extract action items
4. Move files to correct location
5. Write processing summary
4Configure Auto-Memory

Auto-memory is enabled by default. Review the settings to understand what gets stored and where. Claude saves patterns across sessions.

# Memory location for your vault:
~/.claude/projects/<vault-hash>/memory/MEMORY.md

# To view current memory:
claude "/memory"

# To manually add a memory:
claude "Remember: this client prefers French communication"

# Auto-saved entries look like:
## Client Folder Structure
Each client = 4 files: README, Communication-Log,
Technical, Progress
5First Run

Open Claude Code in your vault directory and run the first command. Watch it read your CLAUDE.md, understand your structure, and start working.

# Navigate to your vault
cd /path/to/your-vault

# Start Claude Code
claude

# First command - let it orient itself
"Read CLAUDE.md and MEMORY.md. Summarize what you
know about this vault. Then process my inbox."

# Claude will:
# 1. Read CLAUDE.md - understand identity + structure
# 2. Read MEMORY.md - recall past session context
# 3. Scan 00_Inbox/ - process and route files
# 4. Save new patterns to MEMORY.md

Daily Notes

Daily Briefing: Auto-Generated Every Morning

Claude combines your calendar, CRM state, vault updates, and recent client activity to generate a morning briefing. Priorities, meetings, blockers: all in one file.

1

Read today's calendar events via gogcli

2

Check Attio CRM for overdue tasks and upcoming deadlines

3

Scan recent changes across 01_Projects/Clients/Active/

4

Identify unresolved blockers from Communication-Log.md files

5

Generate prioritized daily brief and write it to 00_Inbox/daily-brief-[date].md

claude -p "Generate my daily briefing.
1. Read calendar: gog --account ayautomate calendar list
2. Check Attio for overdue/due-today tasks
3. Read all Progress.md files in 01_Projects/Clients/Active/
4. Read recent Communication-Log.md entries (last 3 days)
5. Compile:
   - Today's meetings (with client context from vault)
   - Top 3 priorities (based on deadlines + impact)
   - Unresolved blockers (who owns them)
   - Quick wins available today
6. Write to 00_Inbox/daily-brief-[date].md"

Query Patterns

5 Key Workflows for an Active Vault

Each workflow turns passive files into working systems. These are the commands you'll run daily once the vault is wired.

01Capture, Process, Route

Every morning: Claude reads 00_Inbox/, extracts action items from each note, routes to the correct PARA folder, creates tasks in Attio, archives processed items.

claude -p "Read every file in 00_Inbox/. For each file:
1. Determine category (client, internal, idea, resource, junk)
2. Extract action items with owners and deadlines
3. Move file to correct PARA folder:
   - Client notes → 01_Projects/Clients/Active/[client]/
   - Ideas        → 03_Resources/Quick_Prototypes/
   - Tasks        → 02_Areas/Operations/
   - Resources    → 03_Resources/[topic]/
4. For client actions: create Attio task via MCP
5. Write processing summary to 00_Inbox/PROCESSED.md"
02Meeting Notes to Action Items to CRM

Drop a meeting transcript into your vault. Claude reads it, extracts decisions and actions, updates the client's Communication-Log.md, and creates CRM tasks.

claude -p "Read the meeting transcript at 00_Inbox/meeting-[date].md.
1. Identify the client (match against 01_Projects/Clients/Active/)
2. Extract decisions made, action items (who + deadline), blockers
3. Append structured entry to Communication-Log.md
4. Update Progress.md if deliverables changed
5. Create Attio tasks for each action item
6. Move transcript to client folder"
03Knowledge Graph Building

Claude reads all files in a resource folder, finds conceptual connections, and creates an INDEX.md with [[wikilinks]]. Links appear instantly in Obsidian graph view.

claude -p "Read all files in 03_Resources/AI_Agents/.
Find connections between concepts across files.
Create INDEX.md with:
- Topic clusters grouped by theme
- [[wikilinks]] to each file
- Relationship descriptions (X depends on Y)
- Missing topics that should be documented
Use [[filename]] format so Obsidian renders graph edges."
04Progressive Summarization

Claude reads research notes, distills the most valuable insights, adds TL;DR sections, links to source notes, and reduces noise. Your vault gets smarter without getting bigger.

claude -p "Read all files in 03_Resources/Learning/.
For each file:
1. Add a TL;DR section (3-5 bullet points max)
2. Bold the most actionable insights in the body
3. Add [[wikilinks]] to related files in the vault
4. Score information density: HIGH / MEDIUM / LOW
5. Suggest LOW-density files for 04_Archive/
Write summary to 03_Resources/Learning/DIGEST.md"
05Client Snapshot on Demand

Generate a current-state snapshot for any client. Pulls from README, Progress, Communication-Log, and Technical docs. One command for a full client briefing.

claude -p "Generate a current-state snapshot for [Client].
Read:
- 01_Projects/Clients/Active/[Client]/README.md
- 01_Projects/Clients/Active/[Client]/Progress.md
- 01_Projects/Clients/Active/[Client]/Communication-Log.md
- 01_Projects/Clients/Active/[Client]/Technical.md
Output:
- Current sprint status + blockers
- Last 3 communication entries
- Tech stack summary
- Unresolved action items"

Worked Use Cases

3 Real Scenarios, Step by Step

These are the three highest-impact integrations to run first. Each one pays for the setup within the first week.

Use Case 01

Auto-Routing an Inbox Full of Meeting Notes

Scenario

You have 12 unprocessed meeting notes from the last week across 4 different clients.

1

Run claude /inbox-processor from the vault root

2

Claude reads all 12 files, identifies each client by matching keywords against 01_Projects/Clients/Active/

3

Each note is appended to the correct Communication-Log.md

4

Action items extracted and pushed to Attio as tasks

5

Inbox is cleared and a PROCESSED.md summary is written

Result

12 files routed, 18 Attio tasks created, 0 manual decisions required.

Use Case 02

Building a Knowledge Map for AI Agent Research

Scenario

You have 30+ notes on AI agent architectures scattered across Resources/. No index, no connections.

1

Run: claude 'Read all files in 03_Resources/AI_Agents/ and build a knowledge map'

2

Claude scans all 30 files and extracts key concepts

3

Finds overlapping concepts: tool-calling, memory, orchestration, MCP

4

Creates INDEX.md with [[wikilinks]] grouped by theme

5

Obsidian graph view immediately shows the connections

Result

One INDEX.md file makes 30 notes instantly navigable in Obsidian.

Use Case 03

Per-Client CLAUDE.md for Zero-Context Sessions

Scenario

You switch between 5 clients daily. Explaining context to Claude each session wastes 15 minutes.

1

Create /vault/01_Projects/Clients/Active/[Client]/CLAUDE.md per client

2

Include: stack, engineers, conventions, active sprint, blockers

3

When working on a client file, Claude reads all three CLAUDE.md levels

4

Global prefs (no emojis) + vault structure + client specifics, all merged

5

Zero re-explanation. Claude already knows everything

Result

15 minutes saved per client switch. Context is always current because the file is the source of truth.

Auto-Memory System

Claude Builds Its Own Memory About Your Vault

Every session, Claude learns your patterns, preferences, and quirks. This knowledge persists across conversations in a single readable file.

Where it lives

~/.claude/projects/<repo>/memory/MEMORY.md: one file per project, scoped to the vault. Fully readable and editable.

What gets saved

Build quirks, tool preferences, client naming conventions, folder patterns, things that failed before. Example: "always use bun not npm" or "GitButler manages commits; never use git commit directly."

How it learns

Claude detects repeated corrections and patterns. If you say "no emojis" three times, it saves to MEMORY.md automatically. Next session, it already knows.

How to browse

Use /memory to list all memory files. Read them directly in Obsidian or any text editor. Edit or delete entries that are outdated.

Why it matters

Session 1: you explain everything. Session 50: Claude already knows your vault structure, client names, file conventions, and how you like things done. Zero ramp-up time.

# Example MEMORY.md entries

## Git
GitButler is active on this repo. Never use git commit directly.

## Client Folder Structure
Each client = their own folder with 4 files:
- README.md          -- overview, contact, engineers
- Communication-Log.md -- all calls, emails, decisions
- Technical.md       -- stack, architecture
- Progress.md        -- sprints, deliverables, blockers

## User Preferences
- Direct, no fluff
- No emojis -- ever
- Never commit without asking

Want this running in your stack?

AY Automate builds AI automation systems for production teams.