Skip to content

feat: add format_cells tool for cell formatting #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: add format_cells tool for cell formatting #45

wants to merge 1 commit into from
+136 −2

Conversation

@dsuarezf
Copy link

@dsuarezf dsuarezf commented Oct 14, 2025

Summary

This PR adds a new format_cells tool to the MCP server that enables comprehensive cell formatting in Google Sheets.

Features Added

  • Number Formatting: Support for currency, percent, date, time, and custom number formats
  • Background Colors: Apply RGB colors (0-1 range) to cell backgrounds
  • Text Formatting: Control bold, italic, font size, foreground color, and more
  • Alignment: Set horizontal alignment (left, center, right)

Changes

  • Added format_cells() function in src/mcp_google_sheets/server.py (121 lines)
  • Updated README.md with tool documentation and example prompts
  • Updated pyproject.toml version

Usage Examples

"Format cells A1:E1 in Sheet1 with orange background, bold black text."
"Apply currency formatting to cells E2:E10 in the 'Sales' sheet."
"Center align the text in cells B1:D1 and make them bold."

Test plan

  • Test number formatting with different format types (currency, percent, date)
  • Test background color application
  • Test text formatting (bold, italic, font size)
  • Test horizontal alignment options
  • Verify A1 notation parsing for single cells and ranges

@dsuarezf
feat: add format_cells tool for cell formatting in Google Sheets
8b5584c 
Added a new MCP tool that enables formatting of spreadsheet cells including:
- Number formats (currency, percent, date, time, etc.)
- Background colors (RGB with 0-1 range)
- Text formatting (bold, italic, font size, foreground color)
- Horizontal alignment (left, center, right)

Updated documentation with:
- Tool description and parameters in Available Tools section
- New feature highlight in Key Features
- Example prompts demonstrating cell formatting usage
@slhck
Copy link

slhck commented Nov 21, 2025

This looks super useful, any change of this getting tested/merged?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@dsuarezf @slhck