FastMCP server for bidirectional sync between personal and team Obsidian vaults MCP server

vault-sync-mcp

<!-- mycelium-badges:start -->

<!-- mycelium-badges:end -->

A FastMCP server for bidirectional sync between a personal Obsidian vault and a shared team vault. Designed for teams where one person (the vault owner) maintains the source of truth and shares selected content with collaborators via a shared folder (Google Drive, Dropbox, etc.).

Tools

Both push and pull default to dry_run: true — you always preview before executing.

Install

Open Claude Code, paste:

/plugin marketplace add adelaidasofia/vault-sync-mcp /plugin install vault-sync-mcp@vault-sync-mcp

Then edit config.yaml to set your vault paths and sync rules:

personal_vault: ~/vault/
team_vault: ~/team-vault/

Restart Claude Code. Then ask:

"Show me vault sync status"

"Push changes to team vault (dry run first)"

Legacy install

pip install fastmcp python-frontmatter pyyaml xxhash

1. Clone:

git clone https://github.com/adelaidasofia/vault-sync-mcp.git
   cd vault-sync-mcp

1. Edit config.yaml to set your vault paths and sync rules:

personal_vault: ~/vault/
   team_vault: ~/team-vault/

1. Register with Claude Code:

claude mcp add vault-sync -s user -- python3 /path/to/vault-sync-mcp/server.py

1. Restart Claude Code. Then ask:

"Show me vault sync status"

"Push changes to team vault (dry run first)"

Configuration

Everything lives in config.yaml:

personal_vault: ~/vault/
team_vault: ~/team-vault/

no_sync:
  - "Journal/"
  - "Personal/"

sync_rules:
  - path: "Team/"
    direction: bidirectional

  - path: "CRM/"
    direction: personal_to_team
    filter:
      frontmatter_field: relationship
      frontmatter_values: [client, team, advisor]

Sync rule directions

• bidirectional — changes flow both ways
• personaltoteam — personal is source of truth, team gets updates
• teamtopersonal — team is source of truth, personal gets updates (useful for shared docs)

Blocking sync on a file

Add sync: false to any file's frontmatter to exclude it from all sync operations.

Environment variables

Shortened. The full README is on GitHub.