# 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

```bash
pipx install g-gremlin
pipx install g-gremlin-sfdc-mcp

g-gremlin sfdc connect --org-alias dev
```

## Claude Desktop

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

To expose write tools:

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

## Cursor / Windsurf

Use the same MCP server command in your client config:

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

To expose write tools in Cursor/Windsurf, add:

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

## Health check

```bash
g-gremlin-sfdc-mcp --check
```

## Development

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

## License

MIT