🌟 Sync Vault

中文

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.

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) 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

💻 CLI Commands (1.13.0)

Sync Vault provides Obsidian CLI commands for automation scripts and AI Agent workflows:

Common examples:

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

• 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

• 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.

📱 Cloud Service Features

⚙️ Installation and Usage

Install from Plugin Market

Search for sync vault ce in the plugin market, or click here 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"
    }
  }
}

🗺️ Roadmap

• 🌐 More Cloud Services
• 🏠 Collaborative Editing
• 🎨 Better User Experience
• ⎔ Zotero Support
• 🤖 AI Infrastructure

🔗 Quick Links

• 💬 Discord
• 📖 Documentation
• 💬 Discussions
• 🐛 Report Bug
• ✨ Request Feature
• 🥂 Pricing

❤️ Special Thanks

• Obsidian
• React