Claude Obsidian — Self-Organizing AI Second Brain for Obsidian

Introduction

Claude Obsidian connects Claude Code to your Obsidian vault for AI-assisted knowledge management. It reads documents, extracts concepts, creates wikilinks, and organizes notes into your existing folder and tag structure, all as plain Markdown you own.

What Claude Obsidian Does

• Reads source material (PDFs, web pages, text) and creates structured Obsidian notes with YAML frontmatter
• Generates bidirectional wikilinks between related concepts across the vault
• Files notes into appropriate vault folders based on content analysis
• Maintains a consistent tagging taxonomy by analyzing current tag patterns
• Produces daily summaries of newly ingested material with link references

Architecture Overview

The skill interfaces with your local Obsidian vault through the filesystem. It reads the vault's folder structure, existing tags, and link graph to learn your organizational conventions. New content is parsed, chunked into atomic notes, and cross-referenced against existing notes. Output is plain Markdown with YAML frontmatter written directly to the vault directory.

Self-Hosting & Configuration

• Requires Claude Code and an Obsidian vault on the local filesystem
• Set OBSIDIAN_VAULT_PATH to your vault's root directory
• Configure ignored folders via .claude-obsidian.yml
• Supports custom frontmatter schemas for properties like source and status
• Works with any Obsidian plugins since output is standard Markdown

Key Features

• Preserves your existing organizational structure rather than imposing a new one
• Link graph integrates with Obsidian's built-in graph view
• Incremental ingestion processes sources one document at a time
• Handles PDF, HTML, clipboard content, and plain text inputs
• Runs locally with no data sent beyond the LLM API call

Comparison with Similar Tools

• Obsidian Copilot — chat over existing vault contents; Claude Obsidian focuses on ingesting and organizing new material
• Smart Connections — embedding-based linking; Claude Obsidian creates explicit wikilinks with meaningful anchor text
• Mem.ai — cloud-hosted with proprietary storage; Claude Obsidian keeps everything local as plain Markdown
• Khoj — search and retrieval focus; Claude Obsidian emphasizes structured filing and bidirectional linking

FAQ

Q: Does it modify existing notes? A: By default it only creates new files and appends backlink references. It will not alter existing note bodies unless explicitly instructed.

Q: Can I use this with synced vaults (iCloud, Syncthing)? A: Yes. The skill reads and writes to the local path you configure. Any sync layer presenting the vault as a local directory works correctly.

Q: What about unresolved wikilinks? A: Obsidian handles unresolved links natively. You can create the target note later and the link resolves automatically.

Sources

• https://github.com/AgriciDaniel/claude-obsidian
• https://obsidian.md/