Skip to main content
Google Sheets is Google’s cloud-based spreadsheet application for data management and collaboration. The Google Sheets MCP server lets you read, write, and manipulate spreadsheet data using natural language.

What Can It Do?

  • Read spreadsheet data from any range or entire sheets
  • Write and update cells with new values or formulas
  • Create and manage sheets within spreadsheets
  • Search and filter data based on conditions

Where to Use It

Add Google Sheets as a tool to any agent. The agent can then work with your spreadsheets conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add toolsConnect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Google Sheets tools. This gives you the flexibility of an agent within a deterministic workflow.

As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Read the sales data from column A”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

Available Tools

ToolDescription
Read RangeRead data from a specified range
Write RangeWrite data to a range
Append RowsAdd rows to the end of a sheet
Create SheetCreate a new sheet in a spreadsheet
Delete SheetRemove a sheet
Clear RangeClear data from a range
Get Sheet InfoGet spreadsheet metadata
Search DataFind data matching criteria

Example Prompts

Use these with your agent or in the Agent Node: Read data:
Read all data from the Sales sheet in my Q4 Report spreadsheet
Write data:
Update cell B2 in the inventory sheet to 150
Append rows:
Add a new row with "John", "Sales", "2024-01-15" to the employee sheet
Search:
Find all rows where the status column says "Pending"
Get info:
What sheets are in my Budget spreadsheet?

Troubleshooting

IssueSolution
Agent not finding the right dataSpecify the spreadsheet name and sheet tab clearly
Action not completingCheck that you’ve authenticated and have edit access
Unexpected resultsThe agent may chain multiple tools (e.g., reading first, then writing). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Update the total in my budget sheet” will read the current data first, then update. If results seem off, check the agent’s step-by-step reasoning.

Need Help?


Use this integration directly in Claude or Cursor. Connect remotely via the Google Sheets MCP server using your Gumloop credentials.