> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Sheets

> Give an agent access to your connected Google Sheets account so it can create, search, read, and update spreadsheets

Google Sheets gives your agent access to your connected spreadsheets. The agent can create spreadsheets, search files, read values, and append or update rows while it responds to chat messages or completes tasks.

## What it does

When Google Sheets is enabled on an agent, the agent can automatically perform spreadsheet actions as part of its reasoning process. You ask a question or give it a task — the agent decides when and how to use your Google Sheets account on your behalf.

## Prerequisites

You must have an active Google Sheets connection in your workspace before enabling this tool. If no active connection exists, the toggle is disabled.

1. Go to **Integrations** for your workspace.
2. Find **Google Sheets** in the integrations grid.
3. Click **Connect** and complete the OAuth flow.
4. Return to your agent and enable the tool.

## Adding the tool to an agent

1. Open an agent in the editor.
2. Click the button with the tooltip **Add MCP Tool or Sub Agent**.
3. In **MCP Tools**, click **Google Sheets**. The Google Sheets node appears on the canvas.
4. Click the node to open the **Settings** panel on the right.
5. In the **Authentication** field, select the connected Google Sheets account the agent should use.
6. If no active connection is found, the settings panel shows a warning with a link to **Integrations** to connect first.

## Use cases

* Create a spreadsheet from structured workflow output.
* Search for a spreadsheet by name and read its sheet names.
* Append new rows after a workflow collects form responses.
* Update values in an existing range when a report is refreshed.

## Notes

* The agent uses your connected Google Sheets account to perform actions. Make sure the OAuth connection has access to the spreadsheets your workflows need.
* This tool counts as 1 credit per action the agent performs.
* OAuth may show third-party authorization branding during the connect flow.
* If a previous connection stops working, reconnect Google Sheets in **Integrations**, then select the new account on the tool node.

See also: [Integrations](../../workspace/integrations), [Creating and Configuring](../creating-and-configuring)