π Sync Vault
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=trueto show command-specific usage.
β¨ Backup
- 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
- Click the βοΈ icon in the sidebar to open the dashboard, then find the "Beginner Guide" button in the Quick Actions card.
- 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.
npm install -g @mcpwizard/sse-bridge- 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