salesforce

Salesforce MCP Server exposes a suite of tools that let AI assistants interact with Salesforce organizations via the MCP protocol. The server enables actions such as running Apex code, querying Salesforce data, describing objects, and managing Salesforce org connections through the Salesforce CLI. Clients can connect to the server using standard MCP client configurations (for example Claude Desktop, Claude Code, Codex CLI, VS Code Copilot, or Cursor) and issue tool calls that map to Salesforce operations. The server is designed to work with a single or multiple Salesforce orgs (as configured) and can be run directly via npx for quick experimentation or integrated into larger client workflows for automated tasks.

Prerequisites:

• Node.js v18 or higher
• npm (comes with Node.js) or pnpm/yarn as preferred
• Salesforce CLI (sf) installed and authenticated to at least one Salesforce org

Option A: NPM Installation (Recommended)

1. Install and run the MCP server directly from NPM:

npx @advanced-communities/salesforce-mcp-server

2. The command will download and run the latest package with all dependencies handled automatically.

Option B: Manual Installation (from source)

1. Clone the repository:

git clone https://github.com/advancedcommunities/salesforce-mcp-server.git

2. Navigate to the project:

cd salesforce-mcp-server

3. Install and build:

npm install
npm run build

4. Start the server (if a build/index.js is produced):

node build/index.js

Option C: MCP Bundle, or other distribution formats, may be available from releases and can be used according to their instructions.

Add MCP configuration to your client as described in the README to enable usage with Claude Desktop, Claude Code, Codex CLI, VS Code, or other MCP-compatible clients.

Notes and tips:

• The server relies on Node.js and npm; ensure your environment matches the prerequisites (Node 18+).
• You can run the server via npx for quick testing or pin to a specific version if needed.
• Environment variables can be used to tailor behavior (for example READ_ONLY and ALLOWED_ORGS) when running through clients that support MCP env blocks.
• For Claude Desktop integration, you can specify the MCP server in the config under mcpServers with command and args as shown in the README; include env vars if required.
• If you encounter connectivity or authentication issues with Salesforce, verify that sf is installed and that at least one org is authenticated and accessible from the environment running the MCP server.