Claude Sync

An Obsidian plugin that automatically imports Claude chat exports from a watched folder into your vault.

Features

• Auto-import: Watches a folder for new markdown files and imports them to your vault
• Folder preservation: Maintains subdirectory structure from the watch folder
• Configurable: Set custom watch folder, vault destination, and check interval
• Manual sync: Trigger imports manually via command or ribbon icon
• Clean imports: Optionally delete source files after successful import

Installation

Manual Installation

1. Download the latest release (main.js, manifest.json, styles.css)
2. Create a folder called claude-sync in your vault's .obsidian/plugins/ directory
3. Copy the downloaded files into the claude-sync folder
4. Enable the plugin in Obsidian Settings > Community Plugins

From Source

git clone https://github.com/GBAnjos/claude-sync-obsidian
cd claude-sync-obsidian
# Copy files to your vault
cp main.js manifest.json styles.css /path/to/vault/.obsidian/plugins/claude-sync/

Usage

With Claude to Obsidian Chrome Extension

This plugin is designed to work with the Claude to Obsidian Chrome extension:

1. Install this plugin in Obsidian
2. Install the Chrome extension
3. Set the watch folder in plugin settings (default: ~/Downloads/Claude Exports)
4. Export chats from Claude using the extension's "Download" option
5. Files are automatically imported to your vault

Standalone Usage

You can also use this plugin standalone:

1. Configure the watch folder to any directory
2. Drop .md files into the watch folder
3. They'll be automatically imported to your vault

Settings

Setting	Description	Default
Watch folder	Full path to folder to watch for exports	~/Downloads/Claude Exports
Vault folder	Folder inside vault where chats are saved	Claude Chats
Delete after import	Remove files from watch folder after importing	Enabled
Show notifications	Display notification when files are imported	Enabled
Check interval	How often to check for new files (seconds)	5

Commands

• Claude Sync: Sync now - Manually import all files from watch folder
• Claude Sync: Open watch folder - Open the watch folder in your file manager

How It Works

1. The plugin polls the watch folder at the configured interval
2. When new .md files are found, they're read and created in the vault
3. Subdirectory structure is preserved (e.g., watch/project/chat.md → vault/Claude Chats/project/chat.md)
4. If "Delete after import" is enabled, source files are removed
5. Empty directories in the watch folder are cleaned up

Troubleshooting

Files not importing?

• Check that the watch folder path is correct in settings
• Ensure the folder exists (use "Open watch folder" to create it)
• Verify files have .md extension

Duplicate files?

• The plugin skips files that already exist in the vault
• To re-import, delete the file from the vault first

License

MIT

Credits

Created for use with the Claude to Obsidian project.