GuideSeptember 23, 20255 min read

How to Sync Cursor and Claude Code Settings

AI-powered development tools are becoming essential. Here's how to sync your Cursor IDE, Claude Desktop, and Claude Code settings across every machine.

The AI Toolchain Problem

If you use AI-assisted development tools, you likely have configurations spread across multiple applications: Cursor IDE has settings and keybindings, Claude Desktop has MCP server configurations, and Claude Code has its own settings and credentials. None of these tools sync with each other, and none have built-in cross-machine sync.

Setting up a new machine means reconfiguring each tool individually. MCP server definitions are particularly painful to recreate because they involve server URLs, API keys, and specific parameter configurations that you set up once and then forget about.

Syncing Cursor IDE

Cursor is a VS Code fork with built-in AI features. Unlike VS Code, Cursor does not have built-in settings sync. Your settings, keybindings, and extensions only exist on the machine where you configured them.

Add Cursor module
configsync add module cursor

This tracks the key Cursor configuration files:

Tracked Cursor paths
# macOS ~/Library/Application Support/Cursor/User/settings.json ~/Library/Application Support/Cursor/User/keybindings.json # Linux ~/.config/Cursor/User/settings.json ~/.config/Cursor/User/keybindings.json

Your AI model preferences, editor theme, custom keybindings, and all other settings are captured. On a new machine, pull your ConfigSync snapshot and Cursor is configured exactly as you left it.

Syncing Claude Desktop

Claude Desktop stores its configuration including MCP (Model Context Protocol) server definitions in a JSON config file. MCP servers extend Claude with tools like file system access, database queries, web browsing, and custom integrations.

Add Claude Desktop module
configsync add module claude-desktop

The config file is encrypted automatically because it often contains API keys and server URLs for MCP integrations:

Example Claude Desktop config (encrypted by ConfigSync)
{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/jane/projects"] }, "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx" } }, "postgres": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres"], "env": { "DATABASE_URL": "postgresql://user:pass@host:5432/db" } } } }
Why encrypt MCP configs: MCP server definitions frequently contain API keys, database connection strings, and internal server URLs. ConfigSync encrypts the entire config file so these secrets never exist in plaintext outside your machine.

Syncing Claude Code

Claude Code (the CLI tool for Claude) has its own configuration, credentials, and keybindings. It also supports project-level CLAUDE.md files that define instructions for Claude when working in a specific codebase.

Add Claude Code module
configsync add module claude-code

This tracks several files with appropriate security:

What gets tracked
~/.claude/settings.json # plain — preferences and keybindings ~/.claude/credentials.json # encrypted — auth tokens ~/.claude/CLAUDE.md # plain — global instructions for Claude

Your Claude Code credentials are encrypted, while settings and your global CLAUDE.md instructions are stored as plain text since they contain no secrets. On a new machine, pulling restores your authentication so you can start using Claude Code immediately without re-logging in.

Syncing Everything Together

The real power is syncing your entire AI toolchain in one push. Here is the complete setup:

Full AI toolchain sync
# Cursor IDE settings and keybindings configsync add module cursor # Claude Desktop with MCP servers configsync add module claude-desktop # Claude Code settings and credentials configsync add module claude-code # Push everything configsync push -m "AI toolchain config" # On a new machine — one command configsync pull

One pull on a new machine and your entire AI development environment is ready. Cursor opens with your settings. Claude Desktop has all your MCP servers configured. Claude Code is authenticated and has your global instructions loaded.

Combining with Your Other Tools

AI tools do not exist in isolation. You probably also need your shell, editor, git config, and SSH keys. ConfigSync modules compose naturally:

Complete development environment
# AI tools configsync add module cursor configsync add module claude-desktop configsync add module claude-code # Everything else configsync add module zsh configsync add module git configsync add module ssh configsync add module vim # Push once configsync push -m "complete dev environment" # New machine: one command restores everything configsync pull --install

From unboxing a new laptop to a fully configured development environment with all your AI tools, editor settings, shell customizations, and credentials in place. That is the goal, and ConfigSync gets you there in minutes instead of hours.

Ready to try ConfigSync?

Sync your entire dev environment across machines in minutes. Free forever for up to 3 devices.