MCP Libraries
mcp-gsheetsTools Reference

sheets_format_cells

Format cells with colors, fonts, and alignment

sheets_format_cells

Apply formatting to a range of cells including colors, fonts, alignment, and number formats.

Parameters

ParameterTypeRequiredDescription
spreadsheetIdstringYesThe spreadsheet ID
rangestringYesA1 notation range
formatobjectYesFormatting options

Format Options

  • backgroundColor - Background color (RGB object)
  • foregroundColor - Text color (RGB object)
  • bold - Bold text
  • italic - Italic text
  • fontSize - Font size
  • fontFamily - Font family
  • horizontalAlignment - LEFT, CENTER, RIGHT
  • verticalAlignment - TOP, MIDDLE, BOTTOM
  • numberFormat - Number format pattern

Example

{
  "tool": "sheets_format_cells",
  "arguments": {
    "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
    "range": "Sheet1!A1:D1",
    "format": {
      "backgroundColor": { "red": 0.2, "green": 0.4, "blue": 0.8 },
      "foregroundColor": { "red": 1, "green": 1, "blue": 1 },
      "bold": true,
      "fontSize": 12,
      "horizontalAlignment": "CENTER"
    }
  }
}

On this page