Salesforce MCP Server: Connect Claude to Your CRM

Your entire sales pipeline is sitting in Salesforce — leads, opportunities, accounts, contacts, activities — but getting a quick answer out of it means navigating reports, dashboards, and a query language most salespeople never learned. The Salesforce MCP server changes that by giving Claude direct read access to your CRM, so you can ask questions the way you'd ask a colleague.

What Is Salesforce?

Salesforce is the world's leading customer relationship management (CRM) platform, used by over 150,000 businesses to manage sales pipelines, customer interactions, marketing campaigns, and service cases. Its data model is built around core objects — Leads, Contacts, Accounts, Opportunities, and Activities — plus a near-infinite layer of custom objects and fields that orgs add over time. The Model Context Protocol gives Claude a structured way to query all of this data without you ever opening the Salesforce UI.

What the Salesforce MCP Server Does

Once connected, Claude gains access to a set of tools that map directly onto Salesforce's core data operations:

• query records via SOQL — Execute any valid SOQL query, including against custom objects
• get account by name — Pull all fields for a named Account record
• list open opportunities — Retrieve opportunities filtered by stage, close date, or amount
• search leads — Find Lead records by industry, source, status, or creation date
• get contact details — Look up phone, email, title, and account for a named Contact
• list recent activities — See calls, emails, and meetings logged against a record
• check opportunity stage — Get the current stage and next steps for a specific deal

Prerequisites

Before installing, you'll need the following:

• Salesforce org — Developer Edition is free at developer.salesforce.com and includes full API access
• Connected App — Create one in Setup → App Manager → New Connected App; enable OAuth and note your Consumer Key and Secret
• Credentials — Your Salesforce username, password, and security token (found in Settings → My Personal Information → Reset My Security Token)
• Node.js 18+ — Required to run the MCP server via npx

How to Install the Salesforce MCP Server

1. Open your Claude Desktop configuration file (claude_desktop_config.json).
2. Add the Salesforce server block shown in the configuration section below.
3. Set your SF_USERNAME, SF_PASSWORD, and SF_SECURITY_TOKEN environment variables. Never hard-code credentials directly in the JSON — use your OS environment or a secrets manager.
4. Set SF_LOGIN_URL to https://login.salesforce.com for production orgs or https://test.salesforce.com for sandboxes.
5. Save the config file and fully restart Claude Desktop (quit from the system tray, not just close the window).
6. Open a new Claude conversation and type: "List my open opportunities." If Claude returns data, the connection is live.

Configuration JSON

Add this block to the mcpServers object in your claude_desktop_config.json:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-salesforce"],
      "env": {
        "SF_USERNAME": "you@example.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourSecurityToken",
        "SF_LOGIN_URL": "https://login.salesforce.com"
      }
    }
  }
}

Real Use Cases: Claude + Salesforce in Practice

Here's what you can actually ask Claude once the Salesforce MCP server is running — and what happens behind the scenes:

• "Show all opportunities closing this quarter worth over $50,000" — Claude translates this to a SOQL query with a CloseDate filter and Amount threshold, then formats the results as a clean table with deal name, stage, amount, and owner.
• "Find all leads from the Healthcare industry added this month" — Claude queries the Lead object with Industry = 'Healthcare' and CreatedDate filters, returning a list you can immediately act on before a cold outreach session.
• "What's the current stage of the Acme Corp deal?" — Claude looks up the Opportunity linked to the Acme Corp account, returns the stage name, close date, and any recent activity notes logged against it.
• "List all contacts at TechStartup Inc." — Claude fetches the Account record by name and then retrieves associated Contacts with their title, email, and phone number — perfect pre-call research.
• "Run this SOQL: SELECT Name, Amount FROM Opportunity WHERE StageName = 'Negotiation'" — The SOQL passthrough tool executes your query directly, returning raw results — ideal for power users who know exactly what they want.

Pros

• Natural language replaces Salesforce's complex report builder — no SOQL knowledge required for standard queries
• SOQL passthrough gives power users full flexibility to query any standard or custom object
• Excellent for pre-call research — get full account context in seconds without switching apps
• Works with Developer Edition at zero cost for testing and personal use
• Pairs well with HubSpot MCP if you're evaluating CRM options

Cons / Limitations

• Salesforce Connected App setup is complex — first-timers should budget 30+ minutes for initial configuration
• Username + password + security token auth is less secure than a proper OAuth flow — always use a dedicated integration user with minimum permissions, never a personal admin account
• Salesforce API limits apply — Enterprise orgs typically have 15,000 API calls per 24 hours; heavy MCP usage will count toward this limit
• Write operations (creating or updating records) have limited support in the standard server — verify before building workflows that depend on writes
• Sandbox orgs require changing SF_LOGIN_URL to https://test.salesforce.com — a common gotcha that causes auth failures