salesforce-marketing-mcp

A production-ready Model Context Protocol (MCP) server that gives AI assistants (Claude, Cursor, etc.) direct access to Salesforce CRM data. Built for marketing ops, revenue ops, and B2B marketing teams who want AI-assisted access to leads, contacts, campaigns, campaign members, tasks, and 14 reporting tools — all without writing SOQL.

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

Example prompts

Once connected, ask Claude questions like:

"What are my top 5 campaigns by won revenue this quarter?"

"Show me the lead source breakdown for the last 90 days — include conversion rates."

"Create a follow-up task for lead 00Q... due next Friday."

"Which campaigns have the highest ROI? Include cost per lead."

"Show me 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?"

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