# Salesforce DX MCP server

> Query data, deploy metadata, run Apex tests and manage Salesforce orgs from your AI assistant using orgs authorized in the Salesforce CLI.

- Listing: https://mcp.tc/i/salesforce-dx
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [CRM, Sales & Support](https://mcp.tc/c/crm-sales)
- Vendor: Salesforce
- Verified: yes, mcp.tc checked that this is the official server (https://mcp.tc/verify). It says who runs the server, not that it is safe.
- Repository: <https://github.com/salesforcecli/mcp>
- Package: npm `@salesforce/mcp`

## About

Salesforce DX MCP Server lets an assistant work with Salesforce orgs. Tools are grouped into toolsets such as orgs, metadata, data and users, so you can query records, deploy and retrieve metadata, run Apex tests and manage org users. Only the toolsets and tools you enable are exposed.

It runs locally over stdio with npx (@salesforce/mcp) and requires Node.js. There is no API key in the config. You pass one or more locally authorized orgs with the --orgs flag, for example DEFAULT\_TARGET\_ORG, after signing in with the Salesforce CLI (sf org login web). Telemetry is on by default and can be disabled with --no-telemetry.

## What it can do

- Query and manage data in authorized Salesforce orgs
- Deploy and retrieve org metadata
- Run Apex tests
- Manage orgs and org users
- Choose toolsets and individual tools with flags
- Use orgs already authorized in the Salesforce CLI

## Example prompts

- "Run the Apex tests in my default org and summarize the failures."
- "Query the 10 most recently created Accounts in my default org."
- "Deploy the metadata in force-app to my default org."
- "List the orgs I have authorized in the Salesforce CLI."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio salesforce-dx -- npx -y @salesforce/mcp --orgs DEFAULT_TARGET_ORG --toolsets orgs,metadata,data,users
```

2. Start Claude Code and type `/mcp`. **salesforce-dx** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "salesforce-dx": {
      "command": "npx",
      "args": [
        "-y",
        "@salesforce/mcp",
        "--orgs",
        "DEFAULT_TARGET_ORG",
        "--toolsets",
        "orgs,metadata,data,users"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=salesforce-dx&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzYWxlc2ZvcmNlL21jcCIsIi0tb3JncyIsIkRFRkFVTFRfVEFSR0VUX09SRyIsIi0tdG9vbHNldHMiLCJvcmdzLG1ldGFkYXRhLGRhdGEsdXNlcnMiXX0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "salesforce-dx": {
      "command": "npx",
      "args": [
        "-y",
        "@salesforce/mcp",
        "--orgs",
        "DEFAULT_TARGET_ORG",
        "--toolsets",
        "orgs,metadata,data,users"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=salesforce-dx&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40salesforce%2Fmcp%22%2C%22--orgs%22%2C%22DEFAULT_TARGET_ORG%22%2C%22--toolsets%22%2C%22orgs%2Cmetadata%2Cdata%2Cusers%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"salesforce-dx","type":"stdio","command":"npx","args":["-y","@salesforce/mcp","--orgs","DEFAULT_TARGET_ORG","--toolsets","orgs,metadata,data,users"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "salesforce-dx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@salesforce/mcp",
        "--orgs",
        "DEFAULT_TARGET_ORG",
        "--toolsets",
        "orgs,metadata,data,users"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "salesforce-dx": {
      "command": "npx",
      "args": [
        "-y",
        "@salesforce/mcp",
        "--orgs",
        "DEFAULT_TARGET_ORG",
        "--toolsets",
        "orgs,metadata,data,users"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add salesforce-dx -- npx -y @salesforce/mcp --orgs DEFAULT_TARGET_ORG --toolsets orgs,metadata,data,users
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.salesforce-dx]
command = "npx"
args = ["-y", "@salesforce/mcp", "--orgs", "DEFAULT_TARGET_ORG", "--toolsets", "orgs,metadata,data,users"]
```

Needs Node.js on your computer.

### Gemini CLI

```bash
gemini mcp add salesforce-dx npx -- -y @salesforce/mcp --orgs DEFAULT_TARGET_ORG --toolsets orgs,metadata,data,users
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "salesforce-dx": {
      "command": "npx",
      "args": [
        "-y",
        "@salesforce/mcp",
        "--orgs",
        "DEFAULT_TARGET_ORG",
        "--toolsets",
        "orgs,metadata,data,users"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer.

## Details

- Server version: 0.30.15
- Last checked: 2026-10-03
- Listed: 2026-10-03
- Updated: 2026-10-03

---
Source: https://mcp.tc/i/salesforce-dx (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
