Quickstart
Get Datavor installed and run your first database sync in under 5 minutes.
Prerequisites
macOS
10.15 Catalina or later
Node.js
v18.0 or higher
Claude Desktop
latest version
Don't have Node.js? Download it from nodejs.org — install the LTS version.
Step 1 — Install Datavor
Open your Terminal and run:
bash
npm install -g datavor
Confirm it installed correctly:
bash
datavor --version
# → datavor v1.0.0
# → datavor v1.0.0
Step 2 — Configure Claude Desktop
Open this file in any text editor (create it if it doesn't exist):
path
~/Library/Application Support/Claude/claude_desktop_config.json
Add the Datavor entry:
json
{
"mcpServers": {
"datavor": {
"command": "datavor"
}
}
}
"mcpServers": {
"datavor": {
"command": "datavor"
}
}
}
💡
If the file already has other MCP servers, just add the
"datavor" entry inside the existing "mcpServers" block.Step 3 — Restart Claude Desktop
Fully quit Claude Desktop (Cmd + Q) and reopen it. To verify Datavor is connected, look for the tools icon (🔧) in Claude's interface, or type:
you → claude
List all Datavor tools available.
Claude should respond with a list of tools including connect_mysql, connect_postgres, sync_table, and more.
Step 4 — Your First Sync
Now try syncing a table. In Claude Desktop, type a message like:
you → claude
Connect to my MySQL database at localhost, user root, password mypassword, database myapp.
Connect to my PostgreSQL at localhost port 5432, user postgres, password mypass, database myapp_replica.
Sync the users table from MySQL to PostgreSQL.
Connect to my PostgreSQL at localhost port 5432, user postgres, password mypass, database myapp_replica.
Sync the users table from MySQL to PostgreSQL.
claude response
✅ Connected to MySQL — myapp
✅ Connected to PostgreSQL — myapp_replica
⟳ Syncing users table in batches...
✅ Done — 1,248 rows synced in 1.4s · 0 errors
✅ Connected to PostgreSQL — myapp_replica
⟳ Syncing users table in batches...
✅ Done — 1,248 rows synced in 1.4s · 0 errors
🎉
That's it! You've completed your first Datavor sync. Explore the examples to learn about incremental sync, partial sync, and schema comparison.
Troubleshooting
Datavor not found after install
Try
npx datavor --version. If that works, your npm global bin path may not be in your PATH. Run npm bin -g to find it and add it to your shell profile.Claude doesn't recognise Datavor tools
Make sure you fully quit and restarted Claude Desktop after editing the config file. Check the JSON is valid — a missing comma or bracket will prevent it from loading.
Connection refused error
Verify your database is running and accessible. Check the host, port, username, and password. For local databases,
localhost and 127.0.0.1 both work.