G-Gremlin Salesforce MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/mikeheilmann1024/g-gremlin-salesforce-mcp
cd g-gremlin-salesforce-mcp

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add g-gremlin-salesforce -- node "<FULL_PATH_TO_G_GREMLIN_SALESFORCE_MCP>/dist/index.js"

Replace <FULL_PATH_TO_G_GREMLIN_SALESFORCE_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

Standalone Salesforce MCP launcher for g-gremlin.

g-gremlin-salesforce-mcp

Standalone Salesforce MCP launcher for g-gremlin.

This package provides a dedicated g-gremlin-sfdc-mcp command so MCP clients can connect to Salesforce tools without calling the broader g-gremlin CLI directly.

It delegates to:

  • g-gremlin mcp serve (read/analyze tools only)
  • g-gremlin mcp serve --enable-writes (write tools exposed; apply calls still require plan_hash)

Quickstart

pipx install g-gremlin
pipx install g-gremlin-sfdc-mcp

g-gremlin sfdc connect --org-alias dev

Claude Desktop

{
  "mcpServers": {
    "g-gremlin-sfdc": {
      "command": "g-gremlin-sfdc-mcp"
    }
  }
}

To expose write tools:

{
  "mcpServers": {
    "g-gremlin-sfdc": {
      "command": "g-gremlin-sfdc-mcp",
      "args": ["--enable-writes"]
    }
  }
}

Cursor / Windsurf

Use the same MCP server command in your client config:

{
  "mcpServers": {
    "g-gremlin-sfdc": {
      "command": "g-gremlin-sfdc-mcp"
    }
  }
}

To expose write tools in Cursor/Windsurf, add:

{
  "mcpServers": {
    "g-gremlin-sfdc": {
      "command": "g-gremlin-sfdc-mcp",
      "args": ["--enable-writes"]
    }
  }
}

Health check

g-gremlin-sfdc-mcp --check

Development

git clone https://github.com/mikeheilmann1024/g-gremlin-salesforce-mcp
cd g-gremlin-salesforce-mcp
pip install -e ".[dev]"
pytest

License

MIT

Configuration

claude_desktop_config.json
{"mcpServers": {"g-gremlin-sfdc": {"command": "g-gremlin-sfdc-mcp"}}}

Try it

Connect to my Salesforce dev org using the alias 'dev'.
List the available Salesforce objects and their schemas.
Query the latest 10 opportunities from Salesforce.
Apply changes to the Salesforce record with the specified plan hash.

Frequently Asked Questions

What are the key features of G-Gremlin Salesforce?

Standalone launcher for Salesforce tools via g-gremlin. Supports read-only data analysis operations. Optional write-enabled mode for modifying Salesforce data. Compatible with Claude Desktop, Cursor, and Windsurf. Built-in health check functionality.

What can I use G-Gremlin Salesforce for?

Analyzing Salesforce account data directly within an AI chat interface. Automating Salesforce record updates using natural language prompts. Querying Salesforce object schemas for development and debugging. Integrating Salesforce CRM workflows into AI-assisted coding environments.

How do I install G-Gremlin Salesforce?

Install G-Gremlin Salesforce by running: pipx install g-gremlin && pipx install g-gremlin-sfdc-mcp

What MCP clients work with G-Gremlin Salesforce?

G-Gremlin Salesforce works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep G-Gremlin Salesforce docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare