claude-obsidian

by Agrici DanielPluginResearch something

Turns articles, transcripts and notes into a linked Obsidian wiki that cites its sources

The problem it solves

You saved fifty articles on a topic last month, and now you can't find the one point you need or remember where it came from.

For Researchers and studentsWriters and creatorsTeams keeping notes in Markdown

Before: Notes pile up in folders with no links between them, and you dig through old files to find a source.
After: Claude files each source into linked notes with citations, answers questions from your vault and flags dead links and gaps.

Stars: ★ 16k
License: MIT
Cost: Usage-based
For: Claude Code
Contents: Includes scripts

Screenshots

From the project's own repository · 2 images, swipe or use the arrows.

A claude-obsidian vault in Obsidian Graph view, with linked notes grouped into clusters — Image: Agrici Daniel (MIT). Original file

A knowledge map in Obsidian Canvas with index pages, concepts and linked ideas — Image: Agrici Daniel (MIT). Original file

Overview

claude-obsidian is a Claude Code plugin by Agrici Daniel that keeps a knowledge base in an Obsidian vault. You drop papers, articles, transcripts or notes into an inbox folder; Claude writes linked notes that point back to their sources, answers questions from what the vault already holds and runs a health check for dead links and gaps. The notes are plain Markdown files stored on your computer. It suits researchers, students and writers who read a lot.

Changes to your notes are planned first and applied as one step that can roll back, and an edit you make meanwhile stops the write instead of being overwritten.

Try these first

Start with the first one: it is a small task you can check easily.

/claude-obsidian:wiki Set up a vault in this folder and show me the preview before creating anything.First try · preview first
/claude-obsidian:wiki-ingest Turn what is in inbox/ into linked notes.writes notes
/claude-obsidian:wiki-query What do my notes say about [topic]? Cite the notes you used.
/claude-obsidian:wiki-lint List dead links, orphan pages and empty sections.

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

Output	What it is	Reads
Linked notes	Pages written from your sources, each pointing back to where it came from	Your vault
Answers from notes	Questions answered from what the vault holds, with citations, without changing files	Your vault
Health check	Looks for dead links, orphan pages, missing metadata and empty sections	Your vault
Filing modes	Files new notes the Generic, LYT, PARA or Zettelkasten way	Your vault
Roll back	A journal rolls back a change that stopped halfway	Your vault
Web research	Limited web research that runs only after you agree	The web

Good to know

Build a research wiki from material you have already collected. Sources placed in the vault's inbox become linked notes with their sources recorded, and later questions are answered from those notes with citations.

Limits

PDF and EPUB files are stored with their metadata only; the README says there is no built-in text extraction yet.
Web pages are prepared as a plan you approve, and fetching them needs a separate runner. On Windows, writing to the vault needs WSL.

Notes by Agent Flows Hub (original project name: claude-obsidian), written from the creator's documentation, not from running it ourselves. claude-obsidian README: install, skills and safety · claude-obsidian installation guide

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Install Claude Code firstThe plugin adds to Claude Code; it does not work on its own.
Run the commands in a terminalIn a terminal window, not inside the agent or follow the official guide.claude plugin marketplace add AgriciDaniel/claude-obsidian claude plugin install claude-obsidian@agricidaniel-claude-obsidian
Give it a first taskStart Claude Code in an empty folder and run /claude-obsidian:wiki. Check the preview, let it create the vault, then ingest one article and open the new notes in Obsidian.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

Claude Code, installed.
Python 3.11 or newer
Obsidian, if you want to browse the notes as a graph
On Windows, WSL for anything that writes to the vault
It runs scripts and connects to the internet. Read the official page to see what it does before installing.
Pay per use. The AI service it calls charges for what you use.

Details

Made by: Agrici Daniel
License: MIT Terms
For: Claude Code
Runs on: Your computer

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/claude-obsidian/install.md

Other plugins

Codex for Claude Code Lets Claude Code ask OpenAI's Codex to review your changes or take over a task
Design Research Skills Helps you plan user interviews and turn research notes into personas and journey maps
Designer Toolkit Skills Helps you write design case studies, rationale, presentations and interface copy
Discord for Claude Code Lets you message your running Claude Code session from Discord and get replies there
Elephant-Goldfish Model Helps your coding agent draft a feature spec, then has fresh reviewers poke holes in it
Expo Skills Teaches Claude Code how to build, publish and update phone apps made with Expo

See all 30 plugins

GitHub