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