salesforce-marketing-mcp

MCP server for Salesforce — query leads, campaigns, pipeline, and attribution from Claude without writing a line of SOQL.

47 tools spanning Leads, Contacts, Accounts, Campaigns, Campaign Members, Tasks, and Analytics Reports — plus 14 marketing reporting tools (campaign ROI, lead source attribution, pipeline by campaign, MQL trend, CampaignInfluence). Built for marketing ops, revenue ops, and B2B teams who want AI-assisted answers without pestering RevOps for another report.

Why this exists

Marketing ops teams need answers like "which campaigns drove the most pipeline last quarter" or "what's our MQL trend by month" and usually end up pestering RevOps or copy-pasting Lightning report URLs. This server ships those queries as first-class tools — campaign ROI, CampaignInfluence rollups, lead source breakdowns, MQL trends — so anyone with API access can ask in plain English and get a structured answer.

Most Salesforce MCP servers stop at CRUD on standard objects. The 14 marketing reporting tools are the differentiator — they run the queries marketing ops actually needs.

Example prompts

Once installed, ask Claude things like:

• "What are my top 5 campaigns by won revenue this quarter?"
• "Show the lead source breakdown for the last 90 days, with conversion rates."
• "Which campaigns have the highest ROI? Include cost per lead."
• "Show the MQL trend by month for this year."
• "Add all leads from this list to the Q2 Webinar campaign with status 'Invited'."
• "What's our current pipeline summary by stage with weighted values?"
• "Pull CampaignInfluence for our Q1 ABM program and rank by sourced revenue."

Demo

🎥 Walkthrough video coming soon — pulling pipeline by campaign from Claude in under 60 seconds.

Features

• Leads — Search, get, create, update, and convert leads
• Contacts — Search, get, create, update, and look up by email
• Accounts — Search, get, and list contacts per account
• Campaigns — List, get, create, and update campaigns
• Campaign Members — List members, add individuals, bulk-add up to 200, update statuses
• Tasks — Create tasks; list by lead, contact, or campaign
• Analytics Reports — List, run, and describe Salesforce Analytics reports
• Campaign Analytics — ROI calc, member status breakdown, top campaigns, performance trends
• Attribution — Lead source breakdown, pipeline by campaign, CampaignInfluence, won revenue by campaign, lead conversion metrics
• Pipeline — Pipeline summary, pipeline by lead source, MQL trend, forecast summary
• Activity — Activity summary by dimension, recent activities by lead or contact
• Power tools — Raw SOQL, SObject describe, list all objects

Prerequisites

• A Salesforce org (any edition with API access)
• Your Salesforce username, password, and security token
  • To get/reset your security token: Settings > Personal Information > Reset My Security Token
• Node.js 20 or later

No connected app or OAuth setup required.

Setup

1. Install

npm install -g salesforce-marketing-mcp
# or run directly with npx
npx salesforce-marketing-mcp

2. Environment variables

Create a .env file or set them in your shell:

export SF_USERNAME="you@yourcompany.com"
export SF_PASSWORD="yourpassword"
export SF_SECURITY_TOKEN="yourtoken"
# For sandbox:
export SF_LOGIN_URL="https://test.salesforce.com"

Usage

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken",
        "SF_LOGIN_URL": "https://login.salesforce.com"
      }
    }
  }
}

Claude Code

claude mcp add salesforce-marketing-mcp \
  -e SF_USERNAME=you@yourcompany.com \
  -e SF_PASSWORD=yourpassword \
  -e SF_SECURITY_TOKEN=yourtoken \
  -- npx salesforce-marketing-mcp

Cursor

In .cursor/mcp.json:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["salesforce-marketing-mcp"],
      "env": {
        "SF_USERNAME": "you@yourcompany.com",
        "SF_PASSWORD": "yourpassword",
        "SF_SECURITY_TOKEN": "yourtoken"
      }
    }
  }
}

Tools reference

How it works

• Auth: Connects via Salesforce username + password + security token using jsforce. The connection is cached for 25 minutes and automatically refreshed on INVALID_SESSION_ID errors.
• Production and sandbox: Set SF_LOGIN_URL=https://test.salesforce.com to target a sandbox.
• Rate limits: All queries respect Salesforce API limits. Use limit parameters to control result sizes.

License

MIT