G-Gremlin Salesforce MCP Server

Standalone Salesforce MCP launcher for g-gremlin.

README.md

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

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.

Open Conare