MCP Sync

MCP Sync is an MCP server that synchronizes Model Context Protocol configuration files across diverse AI coding tools and desktop environments. Designed for developers who work across multiple AI-assisted programming editors, the tool connects to configuration files for Claude Desktop, Claude Code, Cline, Roo Code, Cursor, and Visual Studio Code. Rather than manually copying JSON snippets and environment variables between separate application directories, users maintain a central master settings file that propagates updates across all supported environments. The tool enables bi-directional synchronization, allowing developers to either push global settings out to specific editors or import existing tool configurations into the central master file. Built-in verification features include automated backup creation prior to applying changes, revision restoration, dry-run previews to inspect diffs, and conflict resolution options. Software engineers use MCP Sync to maintain consistent server access, arguments, environment keys, and command paths without manual duplication. By standardizing configuration storage across Unix-style paths and editor storage directories, it prevents configuration drift and minimizes downtime caused by missing or misconfigured tool endpoints.

Category: AI & LLM Tooling

Tags: cli, configuration, settings, sync

Visit MCP Sync

How to install and configure MCP Sync

1. Install the CLI tool globally with npm: bash npm install -g mcp-sync Alternatively, clone the repository from GitHub and link it: bash git clone https://github.com/sodeyama/sync-mcp-config.git cd sync-mcp-config npm install npm link 2. Initialize the master configuration file: bash mcp-sync init This generates ~/.mcp/mcp_settings.json. 3. Edit your master server settings with your default editor: bash mcp-sync edit 4. Verify planned configuration modifications with a dry run: bash mcp-sync sync --dry-run 5. Push the master settings to all supported tools such as Claude Desktop and Cursor: bash mcp-sync sync

What you can do with MCP Sync

• Synchronizing server declarations between Claude Desktop, Cursor, and Cline using a single CLI command to avoid manual JSON copying. - Previewing configuration diffs with dry-run mode before propagating changes to avoid syntax errors or broken settings across active editors. - Creating automated backups of existing configuration files before updates and restoring prior versions if configuration conflicts occur. - Propagating MCP settings from a specific tool to the master configuration using the source flag during workflow migrations. - Selectively deploying specific MCP server configurations to targeted development tools using the tool filter argument.

Key facts

• Open Source
• https://github.com/sodeyama/sync-mcp-config
• AI & LLM Tooling, Developer Tools & Code Intelligence
• cli, configuration, settings, sync

Part of MCP Servers

How do I install MCP Sync?

You can install MCP Sync globally on your machine using npm by running npm install -g mcp-sync. Alternatively, you can clone the repository from GitHub, run npm install within the directory, and register the binary locally using npm link. Once installed, the command mcp-sync will be available in your terminal environment.

What can MCP Sync do?

MCP Sync manages and synchronizes Model Context Protocol settings across multiple coding editors. It maintains a master JSON configuration file, supports dry runs to inspect diffs, creates automated backups before making file changes, and allows selective synchronization to specific tools. It can also import settings from a specific source tool into the master file.

Which AI coding tools work with MCP Sync?

MCP Sync supports several AI coding tools and editors, including Claude Desktop, Claude Code, Cline, Roo Code, Cursor, and Visual Studio Code. It automatically targets the default configuration paths for each supported client on your machine, including isolated configuration sections within settings files such as Claude Code and VS Code.

How does MCP Sync handle backups and restorations?

MCP Sync automatically generates a backup in the backups directory before applying updates to any configuration file. You can also manually trigger backups for all tools or specific tools using CLI commands. If a problem occurs, you can list available backups and restore specific configurations by backup identifier.

Is MCP Sync open source?

Yes, MCP Sync is an open source tool licensed under the MIT License. You can inspect, modify, and contribute to the source code on GitHub. The open source repository accepts bug reports, feature requests, and pull requests to expand support for additional AI coding environments and features.