trackmcp
Back to directory
lciesielski

mcp-salesforce-example

View on GitHub
5 stars JavaScriptOthers Updated Jul 17, 2025

Documentation

Salesforce MCP Sample Integration

This project provides a basic example of integrating with Salesforce using the Model Context Protocol (MCP). It allows interaction with Salesforce features like sending emails and deploying Apex code through MCP tools.

Prerequisites

  • Node.js and npm (or yarn) installed.
  • A Salesforce org where you can create a Connected App.

Setup

1. Install Dependencies:

bash
npm install
    # or
    yarn install

2. Configure Salesforce Credentials:

    `utils/credentials.js` Example:

    javascript
    import fs from 'fs';
        import path from 'path';
        // You might load these from environment variables, a config file, etc.
    
        export function getSalesforceCredentials() {
            // --- IMPLEMENT YOUR LOGIC HERE to securely load credentials ---
            const loginUrl = "YOUR_SALESFORCE_LOGIN_URL"; // e.g., https://login.salesforce.com or https://yourdomain.my.salesforce.com
            const username = "YOUR_SALESFORCE_USERNAME";
            const clientId = "YOUR_CONNECTED_APP_CONSUMER_KEY";
            // Load your private key used to sign the JWT assertion
            // Ensure the key is formatted correctly, including BEGIN/END lines.
            const privateKey = fs.readFileSync(path.resolve(__dirname, 'path/to/your/server.key'), 'utf8'); 
            // Example: const privateKey = process.env.SF_PRIVATE_KEY;
    
            if (!loginUrl || !username || !clientId || !privateKey) {
                 throw new Error("Missing required Salesforce credentials in utils/credentials.js");
            }
    
            return {
                loginUrl,
                username,
                clientId,
                privateKey
            };
        }

    3. Configuration File:

      Running the Server

      bash
      node server.js

      Demo

      https://github.com/user-attachments/assets/08c8015a-bc57-4c5e-9f3d-4a9d9d310f4c

      Video in higher quality.

      Frequently asked questions

      What is mcp-salesforce-example?

      mcp-salesforce-example is a Model Context Protocol (MCP) server listed in the TrackMCP directory.

      How do I install mcp-salesforce-example?

      Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

      Is mcp-salesforce-example open source?

      Yes — it is hosted on GitHub at https://github.com/lciesielski/mcp-salesforce-example and has 5 stars.

      Related MCP tools

      Run your own MCP server? See who uses it and what to fix.

      Measure it with TrackMCP