Google Sheets MCP logo

Google Sheets MCP

by mkummer225

A Model Context Protocol (MCP) connector for Google Sheets that allows AI agents to interact with spreadsheets directly.

View on GitHub

Last updated: N/A

What is Google Sheets MCP?

Google Sheets MCP is a connector that enables AI agents to directly interact with Google Sheets spreadsheets using the Model Context Protocol. It allows agents to read, write, and manipulate data within spreadsheets.

How to use Google Sheets MCP?

To use Google Sheets MCP, you need to clone the repository, install dependencies, build the project, create OAuth credentials in Google Cloud Platform, and start the MCP server. The provided sample config can be used to integrate the server into your MCP setup. The agent can then use the available actions to interact with Google Sheets by specifying the spreadsheetId or creating a new one.

Key features of Google Sheets MCP

  • Authentication via Google OAuth

  • Listing sheets within a spreadsheet

  • Creating new sheets and spreadsheets

  • Reading and writing data to specific cells, rows, or columns

  • Renaming sheets and spreadsheets

Use cases of Google Sheets MCP

  • Automated data entry and extraction

  • AI-powered data analysis and reporting

  • Integrating spreadsheets into AI workflows

  • Building custom spreadsheet-based applications

  • Programmatically managing and updating spreadsheet data

FAQ from Google Sheets MCP

How do I authenticate with Google Sheets?

You need to create OAuth credentials in Google Cloud Platform and configure the OAuth consent screen. The downloaded credentials file should be placed in the dist subdirectory.

What actions are available?

Available actions include listing sheets, creating sheets/spreadsheets, reading data, editing cells/rows/columns, inserting rows/columns, and renaming sheets/spreadsheets.

Can I use this with any AI agent?

Yes, as long as the AI agent supports the Model Context Protocol (MCP) and can send requests to the Google Sheets MCP server.

How do I specify which spreadsheet to use?

You need to provide the spreadsheetId when calling the relevant actions.

What is the purpose of the refresh_auth action?

The refresh_auth action is used to re-authenticate your Google account when the credentials expire, ensuring continuous access to Google Sheets.