How to connect Google Sheets to Claude

Connect Claude Web, Desktop and Cowork to Google Sheets MCP. Add a new sheet named 'q3 sales', update all rows where status is 'pending', and more using natural language, with authentication handled for you.

Google Sheets logoGoogle Sheets
Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

50 Tools16 Triggers

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Google Sheets account to Claude via Composio Connect, enabling it to add a new sheet named 'Q3 Sales', update all rows where status is 'Pending', create a pie chart of expenses by category, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

You can also connect Claude to multiple Google Sheets accounts with Composio.

Also integrate Google Sheets with

Connecting Google Sheets to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Google Sheets account

Back in Claude, ask it to connect to Google Sheets or give it any Google Sheets-related task.

For example, ask Claude to:

  • "Add a new sheet named 'Q3 Sales'"
  • "Update all rows where status is 'Pending'"
  • "Create a pie chart of expenses by category"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Google Sheets account is ready to use.

What is the Google Sheets Claude Connector, and what's possible with it?

The Google Sheets MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Sheets account. It provides structured and secure access to your spreadsheets, worksheet data, formatting rules, and charts, so your agent can create, read, update, organize, and export spreadsheet content on your behalf.

  • Spreadsheet and worksheet creation: Have your agent create new spreadsheets, add worksheet tabs, copy sheets between spreadsheets, and rename or reorder tabs.
  • Data reading and updates: Let the agent retrieve cell ranges, append new records, update values in batches, clear ranges, and upsert rows using a key.
  • Data organization: Direct your agent to insert or delete rows and columns, sort ranges, apply filters, resize or hide dimensions, and find and replace text.
  • Rules and visual presentation: Instruct your agent to add dropdowns and other data validation rules, manage conditional formatting, and list, move, or resize charts.
  • Search and export: Have your agent find spreadsheets, inspect file details, export entire spreadsheets in supported formats, or export a worksheet or selected range as a PDF.

Troubleshooting

1. Why does Claude not use the Composio connector for Google Sheets?

The connector can show as connected, but Claude must use it in each Google Sheets conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Google Sheets again.

2. Why does Claude show an MCP server error before Google Sheets connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Google Sheets.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Google Sheets.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Google Sheets authorization link not work?

The Composio connector is one server. Your Google Sheets account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Google Sheets connection.
  • Composio creates a fresh Google Sheets authorization link.
  • Open that link in your browser and finish the Google Sheets sign-in.

4. Why do Google Sheets actions fail after they worked before?

The Google Sheets connection can expire or lose permission.

  • Ask Claude to inspect the Google Sheets connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Google Sheets account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Google Sheets.
  • If the action still fails with a permission error, check that the connected account has that permission in Google Sheets itself.

5. How do I switch to a different Google Sheets account?

Claude can manage the Google Sheets connection for you.

  • Ask Claude to disconnect or delete the current Google Sheets account.
  • Ask Claude to connect Google Sheets again.
  • Open the new Composio authorization link for Google Sheets.
  • Sign in with the other Google Sheets account in the browser.
  • After the account connects, ask Claude to retry the Google Sheets task.

6. Why is my Google Sheets connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Google Sheets connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Google Sheets tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Google Sheets.
TOOLS & TRIGGERS

Supported Tools and Triggers

Every Google Sheets action and event your agent gets out of the box.

Add Sheet to Existing Spreadsheet

Add a GRID sheet with rows and columns to an existing spreadsheet.

Aggregate Column Data

Searches for rows where a specific column matches a value and performs mathematical operations on data from another column.

Append Dimension

Tool to append new rows or columns to a sheet, increasing its size.

Auto-Resize Rows or Columns

Auto-fit column widths or row heights for a dimension range using batchUpdate.

Batch Clear Values By Data Filter

Clears one or more ranges of values from a spreadsheet using data filters.

Batch get spreadsheet

Retrieves data from specified cell ranges in a Google Spreadsheet.

Batch Update Values by Data Filter

Tool to update values in ranges matching data filters.

Clear Basic Filter

Tool to clear the basic filter from a sheet.

Clear spreadsheet values

Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells.

Create Chart in Google Sheets

Create a chart in a Google Sheets spreadsheet using the specified data range and chart type.

Create a Google Sheet

Creates a new Google Spreadsheet in Google Drive.

Create spreadsheet column

Creates a new column in a Google Spreadsheet.

Create spreadsheet row

Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above.

Delete Chart from Google Sheets

Delete an existing chart from a Google Sheets spreadsheet.

Delete Dimension (Rows/Columns)

Tool to delete specified rows or columns from a sheet in a Google Spreadsheet.

Delete Sheet

Tool to delete a sheet (worksheet) from a spreadsheet.

Export Drive Spreadsheet

Export an entire native spreadsheet as XLSX, ODS, PDF, ZIP, CSV, or TSV; use Export Sheet as PDF for print layout and range controls.

Export Sheet as PDF

Render one sheet tab or rectangular range as PDF with orientation, gridline, margin, and fit-to-width controls.

Find and Replace in Spreadsheet

Tool to find and replace text in a Google Spreadsheet.

Format cell

Applies text and background cell formatting to a specified range in a Google Sheets worksheet.

Get conditional format rules

List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form.

Get Data Validation Rules

Tool to extract data validation rules from a Google Sheets spreadsheet.

Get Drive File Metadata

Get JSON metadata for one Drive file without downloading its content.

Get sheet names

Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations.

Get Spreadsheet by Data Filter

Returns the spreadsheet at the given ID, filtered by the specified data filters.

Get spreadsheet info

Retrieves metadata for a Google Spreadsheet using its ID.

Insert Dimension in Google Sheet

Tool to insert new rows or columns into a sheet at a specified location.

List Charts in Google Sheets

Lists all charts in a Google Sheets spreadsheet across all sheets, returning chart_id, sheet metadata, chart type, title, and position.

List Drive Changes

Start a Drive change monitor or list one page after an existing token.

Look up spreadsheet row

Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default.

Move or Resize Chart in Google Sheets

Move or resize an existing chart on a Google Sheets spreadsheet.

Move Spreadsheet to Folder

Move an existing Google Spreadsheet to a different Google Drive folder.

Mutate conditional format rules

Add, update, delete, or reorder conditional format rules on a Google Sheet.

Search Developer Metadata

Tool to search for developer metadata in a spreadsheet.

Search Spreadsheets

Search for Google Spreadsheets using various filters including name, content, date ranges, and more.

Set Basic Filter

Tool to set a basic filter on a sheet in a Google Spreadsheet.

Set Data Validation Rule

Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets.

Sort Range

Sorts data within a specified range in a Google Sheet based on one or more sort criteria.

Copy Sheet to Another Spreadsheet

Tool to copy a single sheet from a spreadsheet to another spreadsheet.

Append Values to Spreadsheet

Tool to append values to a spreadsheet.

Batch Clear Spreadsheet Values

Tool to clear one or more ranges of values from a spreadsheet.

Batch Get Spreadsheet Values by Data Filter

Tool to return one or more ranges of values from a spreadsheet that match the specified data filters.

Update Chart in Google Sheets

Update the specification of an existing chart in a Google Sheets spreadsheet.

Update Dimension Properties (Hide/Unhide & Resize)

Tool to hide/unhide rows or columns and set row heights or column widths.

Update Sheet Properties

Tool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties.

Update Spreadsheet Properties

Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings.

Batch update spreadsheet values

Tool to set values in one or more ranges of a spreadsheet.

Upsert Rows (Smart Update/Insert)

Upsert rows - update existing rows by key, append new ones.

Get spreadsheet values

Returns a range of values from a spreadsheet.

Update spreadsheet values

Tool to set values in a range of a Google Spreadsheet.

FAQ

Frequently asked questions

With a standalone Google Sheets MCP server, the agents and LLMs can only access a fixed set of Google Sheets tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Sheets and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Sheets tools.

Yes, absolutely. You can configure which Google Sheets scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Sheets data and credentials are handled as safely as possible.

Start with Google Sheets.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Sheets tool your agent needs.Free to start.

Start building