# list_sheet_named_ranges (https://sellersheetai.com/docs/mcp-api/tools/list_sheet_named_ranges)

> List all named ranges in the spreadsheet.

Access: **READ** · toolset google_workspace · family null

## Call it

MCP tool call:

```json
{
  "name": "list_sheet_named_ranges",
  "arguments": {
    "spreadsheet_id": "<spreadsheet_id>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/list_sheet_named_ranges \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spreadsheet_id":"<spreadsheet_id>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `spreadsheet_id` | string | yes | the spreadsheet ID (from its URL or get_sheet_metadata). |

## Result

- `data.namedRanges[]` — {namedRangeId, name, range}. range is a GridRange {sheetId, startRowIndex, endRowIndex, startColumnIndex, endColumnIndex}: 0-based, with exclusive ends, not A1.
- `data.count` — the number of named ranges.

## Example

- list_sheet_named_ranges("1ABC...")