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.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

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

Aggregates data from a column in a Google Sheet, either across all rows or rows matching column-value filters.

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 values 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 a specified data range and chart type, or an optional full chart specification.

Create a Google Sheet

Creates a new Google Spreadsheet in Drive with an optional title and folder ID or exact folder name.

Create spreadsheet column

Inserts a new column in a Google Spreadsheet at a specified index.

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

Finds and replaces text across cells in a Google Spreadsheet, scoped to a sheet, range, or all sheets; if no scope is specified, it searches all sheets.

Format cell

Formats a specified cell 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 specified A1 range or the first sheet where a cell matches the query after Unicode and invisible-character normalization.

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 accessible in Drive by name, content, dates, and other filters, including starred and shared-with-me status.

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

Retrieves one or more ranges of values from a Google Spreadsheet using data filters.

Update Chart in Google Sheets

Updates an existing chart in a Google Sheets spreadsheet by replacing its chart specification.

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)

Upserts rows in a Google Sheet by matching a key column: updates matching rows and appends new ones.

Get spreadsheet values

Returns a range of values from a spreadsheet.

Update spreadsheet values

Sets or overwrites values in a Google Spreadsheet range, adjusting the range to fit the supplied values and potentially expanding the sheet by default.

FAQ

Frequently asked questions

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