README file from
GithubClaude 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
- Download the latest release (
main.js,manifest.json,styles.css) - Create a folder called
claude-syncin your vault's.obsidian/plugins/directory - Copy the downloaded files into the
claude-syncfolder - 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:
- Install this plugin in Obsidian
- Install the Chrome extension
- Set the watch folder in plugin settings (default:
~/Downloads/Claude Exports) - Export chats from Claude using the extension's "Download" option
- Files are automatically imported to your vault
Standalone Usage
You can also use this plugin standalone:
- Configure the watch folder to any directory
- Drop
.mdfiles into the watch folder - 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
- The plugin polls the watch folder at the configured interval
- When new
.mdfiles are found, they're read and created in the vault - Subdirectory structure is preserved (e.g.,
watch/project/chat.md→vault/Claude Chats/project/chat.md) - If "Delete after import" is enabled, source files are removed
- 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
.mdextension
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.