obsidian-catalog

Sync Claude conversations into an Obsidian vault with Dataview-compatible frontmatter.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/darkstargeo/claude-to-obsidian --skill obsidian-catalog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-catalog
Source: https://github.com/darkstargeo/claude-to-obsidian/tree/main/skill
Command: npx skills add https://github.com/darkstargeo/claude-to-obsidian --skill obsidian-catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, click, jinja2, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you catalog Claude conversations (browser exports and Claude Code sessions) into an Obsidian vault with rich frontmatter, enabling fast search, organization, and durable knowledge capture.

Core Features & Use Cases

  • Rich Frontmatter: Each session includes metadata like session_id, date, topics, summary, and more for seamless Dataview queries.
  • Dataview Compatibility: Structured data supports powerful in-notebook analytics and dashboards.
  • Organized Structure: Sessions are grouped under Sessions/Browser and Sessions/Code to mirror your workflow.
  • Incremental Sync: Only new sessions are processed on subsequent runs.
  • Raw Data Preservation: Original exports are retained for re-processing or auditing.
  • ** Claude Code Skill Integration**: Naturally interacts with Claude Code history for complete context.

Quick Start

Run a full sync to import all Claude conversations into your Obsidian vault: python ~/.claude/skills/obsidian-catalog/scripts/sync.py --all

Frequently Asked Questions about obsidian-catalog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Claude conversations into Obsidian?

Sync Claude conversations by running the obsidian-catalog script, which imports browser exports and Claude Code history into your Obsidian vault as organized Markdown files with rich frontmatter metadata, enabling searchable catalogs under Sessions/Browser and Sessions/Code folders.

Can I query Claude conversation metadata with Dataview?

Yes. Obsidian-catalog writes structured frontmatter (session_id, date, topics, summary) compatible with Dataview queries, allowing you to filter and analyze conversations by date, topic, or project directly in your vault dashboards.

What file formats does obsidian-catalog accept for Claude exports?

Obsidian-catalog processes browser exports and Claude Code history files, converting them into Markdown with frontmatter. It preserves original exports for re-processing or auditing while creating indexed, queryable session records.

Does obsidian-catalog require manual setup for each sync run?

No. Obsidian-catalog performs incremental syncs, processing only new sessions on subsequent runs. Full syncs import all conversations at once, then only new additions are fetched—no manual re-cataloging needed.

What happens to my original Claude conversation exports after import?

Original exports are retained in raw form for re-processing or auditing purposes. Obsidian-catalog preserves them while creating separate indexed Markdown files with metadata and summaries for fast search and organization.

Can I use obsidian-catalog to organize conversations by project or topic?

Yes. The frontmatter includes topic and project metadata, and the Dataview-compatible structure supports filtering and dashboard creation by any metadata field, letting you organize conversations by project, date, or topic automatically.