ai-agent

claude-obsidian: Build a Self‑Organizing AI Knowledge Graph in Obsidian

Name: claude-obsidian: Build a Self‑Organizing AI Knowledge Graph in Obsidian
Author: AgriciDaniel

Turn any source into linked Markdown notes, creating a personal knowledge graph for founders who need AI‑enhanced PKM. Open‑source, 15k+ GitHub stars.

From the repo · “Self-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.”

15,804 stars+186★ this week1,571 forksPythonGuide quality 8/10 · reviewed Oct 6Updated 10/22/2026100% free · open source

What it does

Claude-Obsidian is a self-organizing AI second brain that reads, links, and files sources into a connected knowledge graph of plain Markdown for Obsidian and Claude Code.

When to use it

•When you need to organize and connect a large number of notes and sources in Obsidian
•When you want to use AI-powered note-taking and personal knowledge management
•When you're looking for an open-source alternative to Notion with advanced AI features

Ready-to-paste prompt

Drop a Markdown file containing a research paper into the `inbox` folder and run `claude --source inbox/research_paper.md --output graph.md` to generate a new note with links and connections

Heads up: Make sure you have a Claude API key and Python 3.8 or later installed before running the `claude` command, as the plugin relies on these dependencies to function correctly

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

⚡ Runs out of the box

A prompt/skill package — nothing to install beyond adding it to your AI tool.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/claude-obsidian && curl -fsSL https://workflowstacks.com/api/skills/claude-obsidian/claude-skill -o ~/.claude/skills/claude-obsidian/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How claude-obsidian: Build a Self‑Organizing AI Knowledge Graph in Obsidian works

Codeflow

Free to inspect

Claude-obsidian: Build a Self‑Organizing AI Knowledge Graph in Obsidian is a large Python project (~23k lines across 36 code files, plus 36 test files). You install it into your AI tool with one command; there is nothing to run yourself. Last commit this month, MIT license, has a test suite.

Size

Large codebase

~23k lines · 36 code files · ~3 h to skim

Setup

Install as a skill / plugin

Add it to Claude Code (or your AI tool) with one command — 16 skills inside. Nothing to run yourself.

Runs on

Inside your AI tool

Nothing to install on your machine

Python 96%Shell 4%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
claude_obsidian/cli.py
Where the program starts running
4
skills/autoresearch/SKILL.md
Inside skills/ — an example of what the AI is told to do
5
examples/sample-vault/.claude-obsidian.json
A worked example — copy this to get going

What's in each folder

skills/Prompts, skills & agent definitions34 files

claude_obsidian/Core code — the actual logic20 files

agents/Prompts, skills & agent definitions3 files

bin/Command-line entry points5 files

examples/Examples you can copy13 files

templates/Templates11 files

docs/Documentation5 files

scripts/Helper scripts11 files

READMEHas testsDocumentedCI checksExamples includedMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

⚡ Runs out of the box

A prompt/skill package — nothing to install beyond adding it to your AI tool.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/claude-obsidian && curl -fsSL https://workflowstacks.com/api/skills/claude-obsidian/claude-skill -o ~/.claude/skills/claude-obsidian/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

AgriciDaniel

Language

Python