← Tools Reference

Google Sheets

Spreadsheet access for reading and managing sheets

OAuth8 toolshttps://sheets.googleapis.com/v4
GET
google_sheets_get_spreadsheet
Get metadata (sheets, properties) for a spreadsheet

/spreadsheets/{spreadsheetId}

2 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID (from its URL)
includeGridDatabooleanoptionalInclude cell data in the response
POST
google_sheets_create_spreadsheet
Create a new spreadsheet

/spreadsheets

2 parameters
ParamTypeRequiredDescription
propertiesobjectoptionalSpreadsheet properties, e.g. { title: 'My Sheet' }
sheetsarrayoptionalInitial sheets to create
GET
google_sheets_get_values
Read cell values from a range

/spreadsheets/{spreadsheetId}/values/{range}

3 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
rangestringrequiredA1 notation range, e.g. 'Sheet1!A1:D10'
valueRenderOptionstringoptionalHow values are rendered (FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA)
GET
google_sheets_batch_get_values
Read cell values from multiple ranges in one call

/spreadsheets/{spreadsheetId}/values:batchGet

3 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
rangesarrayrequiredA1 notation ranges to read
valueRenderOptionstringoptionalHow values are rendered
PUT
google_sheets_update_values
Overwrite cell values in a range

/spreadsheets/{spreadsheetId}/values/{range}

4 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
rangestringrequiredA1 notation range to write, e.g. 'Sheet1!A1'
valueInputOptionstringrequiredHow input is interpreted (RAW or USER_ENTERED)
valuesarrayrequired2D array of row values
POST
google_sheets_append_values
Append rows of values after the last row of data in a range

/spreadsheets/{spreadsheetId}/values/{range}:append

4 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
rangestringrequiredA1 notation range to search for a table, e.g. 'Sheet1!A1'
valueInputOptionstringrequiredHow input is interpreted (RAW or USER_ENTERED)
valuesarrayrequired2D array of row values to append
POST
google_sheets_clear_values
Clear cell values in a range (leaves formatting intact)

/spreadsheets/{spreadsheetId}/values/{range}:clear

2 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
rangestringrequiredA1 notation range to clear
POST
google_sheets_batch_update
Apply structural/formatting updates (add sheet, resize columns, etc.) in one atomic call

/spreadsheets/{spreadsheetId}:batchUpdate

2 parameters
ParamTypeRequiredDescription
spreadsheetIdstringrequiredSpreadsheet ID
requestsarrayrequiredList of update request objects (addSheet, updateCells, etc.)