obsidian-sync-vault-ce
Professional cloud sync & VFS for Obsidian. Features zero-space VFS, 4K streaming, MCP AI engine, and P2P collaboration. Supports Baidu/Aliyun/Quark/WebDAV/S3.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/abcamus/obsidian-sync-vault-ce with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/abcamus/obsidian-sync-vault-ce'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/abcamus--obsidian-sync-vault-ce)HTML
<a href="/listings/abcamus--obsidian-sync-vault-ce"><img src="/api/listings/abcamus--obsidian-sync-vault-ce/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install from Plugin Market
Search for `sync vault ce` in the plugin market, or [click here](https://obsidian.md/plugins?id=sync-vault-ce) to install quickly.
Get Started
1. Click the ☁️ icon in the sidebar to open the dashboard, then find the "Beginner Guide" button in the Quick Actions card. 2. Click the **Beginner Guide** button and follow the prompts to complete cloud drive login and sync mode settings.
Configure MCP (SSE)
Claude Code CLI
Add the following code in `.claude/mcp.json` (Note: change 3000 to the actual port):
{
"mcpServers": {
"sync-vault-mcp": {
"type": "sse",
"url": "http://127.0.0.1:3000/sse"
}
}
}Claude Desktop
> Since Claude Desktop only supports STDIO method to connect MCP Server, you can choose a bridge to connect Sync Vault MCP. Here you can choose sse-bridge.
1. `npm install -g @mcpwizard/sse-bridge` 2. In Claude Desktop [Settings] - [Developer], click the edit configuration button, copy and paste the following code.
{
"mcpServers": {
"sync-vault-mcp": {
"command": "npx",
"args": [
"@mcpwizard/sse-bridge",
"http://127.0.0.1:3000/sse"
]
}
}
}Cursor/Trae
In Cursor/Trae's MCP settings, choose to manually add MCP Server (Sync Vault MCP defaults to `http://127.0.0.1:3000/sse`).
{
"mcpServers": {
"sync-vault-mcp": {
"type": "sse",
"url": "http://127.0.0.1:3000/sse"
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 201 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 🌟 Sync Vault
- <p align="center">
- <a href="./README_ZH.md">中文</a>
- </p>
- <p align="center">
- <a href="https://github.com/abcamus/obsidian-sync-vault-ce"><img src="https://img.shields.io/github/stars/abcamus/obsidian-sync-vault-ce?style=social" alt="GitHub Stars"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL3.0-green?style=flat-square" alt="License"></a>
- <a href="https://kqiu.top"><img src="https://img.shields.io/badge/Obsidian-Plugin-purple?style=flat-square&logo=obsidian" alt="Obsidian Plugin"></a>
- <a href="https://github.com/abcamus/obsidian-sync-vault-ce/releases"><img src="https://img.shields.io/github/v/release/abcamus/obsidian-sync-vault-ce?include_prereleases&style=flat-square" alt="Latest Release"></a>
- <a href="https://github.com/abcamus/obsidian-sync-vault-ce/releases"><img src="https://img.shields.io/github/downloads/abcamus/obsidian-sync-vault-ce/total?style=flat-square" alt="Total Downloads"></a>
- <br>
- <a href="https://kqiu.top"><img src="https://img.shields.io/badge/Official%20Site-Visit-blue?style=flat-square" alt="Official Site"></a>
- <a href="https://discord.com/invite/J3JdQX7WTG"><img src="https://img.shields.io/badge/Discord-Join%20Community-7289DA?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a>
- </p>
- <p align="center">
- The missing bridge between your 10 TB cloud drive and your AI brain. Access, sync, and link everything—images, PDFs, audio, video—across devices without filling up local storage.
- </p>
- <p align="center">
- <img src="assets/demo.png" alt="Sync Vault Demo">
- </p>
- ## Key Features
- ### 🔗 Link Notes and Cloud Resources
- > Generate links based on file ID and path, integrated into Obsidian notes after rendering.
- - `[]()` format to link cloud resources.
- - `![]()` format to embed cloud resources.
- ### 🤖 MCP Server
- Built-in [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) Server, allowing LLMs / AI Agents to directly access and operate on files in your Cloud Storage.
- - Compatible with MCP-supported clients such as Claude Code and Cursor.
- - Provides real-time context access via SSE (Server-Sent Events).
- #### 🛠️ MCP Tool Capabilities
- | Tool Name | Description | Note |
- | :--- | :--- | :--- |
- | `get_cloud_account_info` | Get cloud account and storage capacity info | |
- | `list_cloud_files` | List files and folders at a specified cloud path | |
- | `read_cloud_file` | Read cloud file content (supports streaming) | |
- | `create_cloud_file` | Create a new file or folder in the cloud | |
- | `delete_cloud_file` | Delete a cloud file or folder | |
- | `move_cloud_file` | Move a cloud file or folder | |
- | `rename_cloud_file` | Rename a cloud file or folder | |
- | `download_cloud_file` | Download a cloud file to local storage | |
- | `upload_cloud_file` | Upload a local file to the cloud | |
- | `semantic_search` | Global search based on semantics | Baidu Netdisk only |
- | `sharelink_set` | Set/Create a sharing link | Baidu Netdisk only |
- | `upload_by_url` | Upload via offline URL task | Baidu Netdisk only |
- ### 💻 CLI Commands (1.13.0)
- Sync Vault provides Obsidian CLI commands for automation scripts and AI Agent workflows:
- | Command | Purpose | Common Parameters |
- | :--- | :--- | :--- |
- | `sync-vault:help` | Show CLI command help | `help=true` |
- | `sync-vault:list` | List cloud directory files (pagination/filter/recursive) | `path` `cloud` `limit` `offset` `type` `minSize` `modifiedAfter` `recursive` |
- | `sync-vault:search` | Search cloud files (with pagination/type filter) | `query` `cloud` `limit` `offset` `path` `type` |
- | `sync-vault:read` | Read cloud file content | `path` `cloud` `maxLength` |
- | `sync-vault:info` | Get account and storage status | `cloud` |
- | `sync-vault:doctor` | Diagnose Sync Vault health status | `cloud` |
- Common examples:
- ```bash
- obsidian sync-vault:list path=/ cloud=aliyun limit=100 offset=0
- obsidian sync-vault:search query=obsidian cloud=quark type=markdown
- obsidian sync-vault:read path=/Notes/Welcome.md cloud=onedrive maxLength=8192
- obsidian sync-vault:info cloud=aliyun
- obsidian sync-vault:doctor cloud=aliyun
- ```
- > Tip: all sub-commands support `help=true` to show command-specific usage.
- ### ✨ Backup
- [Introduction](https://mp.weixin.qq.com/s/zct07eny-LcMTiYjb49k9w)
- - Easily upload data to various cloud drives.
- - Freely switch cloud vaults and backup data to multiple directories.
- ### 🔄 Multi-device Auto Sync
- [Baidu Netdisk Bi-directional Sync Demo](https://github.com/user-attachments/assets/fbc8c22a-9de2-42c4-b676-753007e5e031)
- - Supports bi-directional and one-way sync, automatically identifies file deletion & move operations.
- - Automatic merge of content conflicts.
- - File deletion is recoverable.
- - Ignore large files, ignore files by name using regular expressions.
- - Sync third-party plugins and themes.
- - End-to-end encryption for Markdown files.
- ### 🤝 Collaborative Editing
- Distributed collaborative editing, [Demo](https://github.com/user-attachments/assets/85d63239-2c5c-4d73-8774-f4ea2f93f426).
- ## 📱 Cloud Service Features
- | No. | Cloud Service | Supported Features |
- | :-- | :------------ | :----------------- |
- | 1 | Baidu Netdisk | Backup, Sync, Online Image Preview, Online PDF Reading, Video Playback, Audio Playback, Cloud Link |
- | 2 | OneDrive | Backup, Sync, Online Image Preview, Online PDF Reading, Audio Playback, Video Playback, Cloud Link |
- | 3 | Aliyun Drive | Backup, Sync, Online Image Preview, Online PDF Reading, Audio Playback, Video Playback, Cloud Link |
- | 4 | 115 Drive | Online Image Preview, Online PDF Reading, Audio Playback, Video Playback, Cloud Link |
- | 5 | Quark Drive | Backup, Sync, Online Image Preview, Online PDF Reading, Cloud Link |
- | 6 | Tencent COS | Backup, Sync |
- | 7 | Nutstore | Backup, Sync |
- | 8 | InfiniCloud | Backup, Sync |
- | 9 | 123 Pan | Backup, Sync |
- ## ⚙️ Installation and Usage
- ### Install from Plugin Market
- Search for `sync vault ce` in the plugin market, or [click here](https://obsidian.md/plugins?id=sync-vault-ce) to install quickly.
- ### Get Started
- 1. Click the ☁️ icon in the sidebar to open the dashboard, then find the "Beginner Guide" button in the Quick Actions card.
- 2. Click the **Beginner Guide** button and follow the prompts to complete cloud drive login and sync mode settings.
- ### Configure MCP (SSE)
- #### Claude Code CLI
- Add the following code in `.claude/mcp.json` (Note: change 3000 to the actual port):
- ```json
- {
- "mcpServers": {
- "sync-vault-mcp": {
- "type": "sse",
- "url": "http://127.0.0.1:3000/sse"
- }
- }
- }
- ```
- #### Claude Desktop
- > Since Claude Desktop only supports STDIO method to connect MCP Server, you can choose a bridge to connect Sync Vault MCP. Here you can choose sse-bridge.
- 1. `npm install -g @mcpwizard/sse-bridge`
- 2. In Claude Desktop [Settings] - [Developer], click the edit configuration button, copy and paste the following code.
- ```json
- {
- "mcpServers": {
- "sync-vault-mcp": {
- "command": "npx",
- "args": [
- "@mcpwizard/sse-bridge",
- "http://127.0.0.1:3000/sse"
- ]
- }
- }
- }
- ```
- #### Cursor/Trae
- In Cursor/Trae's MCP settings, choose to manually add MCP Server (Sync Vault MCP defaults to `http://127.0.0.1:3000/sse`).
- ```json
- {
- "mcpServers": {
- "sync-vault-mcp": {
- "type": "sse",
- "url": "http://127.0.0.1:3000/sse"
- }
- }
- }
- ```
- ## 🗺️ Roadmap
- - 🌐 More Cloud Services
- - 🏠 Collaborative Editing
- - 🎨 Better User Experience
- - ⎔ Zotero Support
- - 🤖 AI Infrastructure
- ## 🔗 Quick Links
- - [💬 Discord](https://discord.gg/GT6B8keY)
- - [📖 Documentation](https://kqiu.top/docs/)
- - [💬 Discussions](https://github.com/abcamus/obsidian-sync-vault-ce/discussions)
- - [🐛 Report Bug](https://github.com/abcamus/obsidian-sync-vault-ce/issues/new?template=bug_report.md)
- - [✨ Request Feature](https://github.com/abcamus/obsidian-sync-vault-ce/issues/new?template=feature_request.md)
- - [🥂 Pricing](https://kqiu.top/product/sync-vault/)
- ## ❤️ Special Thanks
- - [Obsidian](https://obsidian.md/)
- - [React](https://react.dev/)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.