To get the latest product updates delivered to you, add the URL of this page to your
[feed
reader](https://wikipedia.org/wiki/Comparison_of_feed_aggregators), or add the feed URL directly: `https://developers.google.com/feeds/sheets-release-notes.xml`.
This page contains release notes for features and updates to the
Sheets API. We recommend that
Sheets API developers periodically check this list for any new
announcements.

## October 12, 2026

Announcement OAuth 2.0 clients calling the Google Sheets Model Context Protocol (MCP) server
are required to have **Use this client for an AI-powered agent** selected in
**Google Auth Platform** **\>** **Clients**.

Starting November 11, 2026, Google Workspace MCP servers will reject requests
from any app or integration whose OAuth client is not marked as agentic by
selecting **Use this client for an AI-powered agent**. OAuth clients that are
not marked as agentic by November 12, 2026 will remain non-agentic and can't
call Google Workspace MCP servers. To use MCP after this date, you will need to
create a new OAuth client marked as agentic and update your app to use it.

Apps and integrations that are not AI agents, like those that only call Google
Workspace REST APIs, are not affected by this change. If an existing OAuth
client is used for both AI agent and non-agent features, create a separate OAuth
client for the AI agent and mark only that client as agentic. Keep the existing
client for your non-agent features.

The Google Sheets MCP server is available as part of the [Developer Preview
Program](https://developers.google.com/workspace/preview). For instructions on
configuring an OAuth 2.0 client for the Google Sheets MCP server, see [Set up
the Google Sheets MCP
server](https://developers.google.com/workspace/sheets/api/guides/configure-mcp-server#configure-mcp-client)
and [Manage OAuth Clients](https://support.google.com/cloud/answer/15549257).

## October 01, 2026

Feature **[Developer Preview](https://developers.google.com/workspace/preview)**: The
Google Sheets Model Context Protocol (MCP) server now supports reading and
managing spreadsheet comments:

- Include comments when retrieving a spreadsheet by setting the optional `commentsIncluded` field on the [`get_spreadsheet`](https://developers.google.com/workspace/sheets/api/reference/mcp/tools_list/get_spreadsheet) tool.
- Create, reply to, resolve or reopen, update, and delete comments and replies using the [`update_spreadsheet`](https://developers.google.com/workspace/sheets/api/reference/mcp/tools_list/update_spreadsheet) tool with the `insertComment`, `addCommentReply`, `updateCommentPost`, `deleteComment`, and `deleteCommentReply` operations.

To learn more, see [Configure the Sheets MCP
server](https://developers.google.com/workspace/sheets/api/guides/configure-mcp-server)
and the [Sheets MCP tool
reference](https://developers.google.com/workspace/sheets/api/reference/mcp).
Feature **[Developer Preview](https://developers.google.com/workspace/preview)**: The
Google Sheets Model Context Protocol (MCP) server and its reference
documentation include the following updates:

- Added the optional `fields` (field mask) and `ranges` (A1 or R1C1 notation) parameters to [`get_spreadsheet`](https://developers.google.com/workspace/sheets/api/reference/mcp/tools_list/get_spreadsheet).
- Added the optional `writeControl` (`WriteControl` with `requiredRevisionId`) parameter to [`update_spreadsheet`](https://developers.google.com/workspace/sheets/api/reference/mcp/tools_list/update_spreadsheet), along with inline request schemas in tool descriptions across the Sheets MCP reference pages.
- Expanded the Tool Annotations section across tool reference pages with definitions of `readOnlyHint`, `destructiveHint`, `idempotentHint`, and `openWorldHint`.

To learn more, see [Configure the Sheets MCP
server](https://developers.google.com/workspace/sheets/api/guides/configure-mcp-server)
and the [Sheets MCP tool
reference](https://developers.google.com/workspace/sheets/api/reference/mcp).

## September 30, 2026

Feature **Generally Available:** You can now programmatically read, create, and manage
comments in Google Sheets with the Google Sheets API. This includes:

- Reading comment threads and anchors by setting [`commentsViewMode`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets#CommentsViewMode) in [`spreadsheets.get`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get) or [`spreadsheets.getByDataFilter`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/getByDataFilter).
- Creating comment threads and replying to comment threads using [`InsertCommentRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#insertcommentrequest) and [`AddCommentReplyRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#addcommentreplyrequest).
- Modifying existing comment and reply posts using [`UpdateCommentPostRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#updatecommentpostrequest).
- Deleting comments and replies using [`DeleteCommentRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#deletecommentrequest) and [`DeleteCommentReplyRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#deletecommentreplyrequest).

For more information, see [Manage
comments](https://developers.google.com/workspace/sheets/api/guides/comments).

## July 23, 2026

Feature **Developer Preview**: You can now programmatically create and manage comments
in Google Sheets with the Google Sheets API. This includes:

- Creating comment threads and replying to comment threads using the
  [`InsertCommentRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#insertcommentrequest)
  and
  [`AddCommentReplyRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#addcommentreplyrequest).

- Modifying existing comment and reply posts using
  [`UpdateCommentPostRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#updatecommentpostrequest).

- Deleting comments and replies using
  [`DeleteCommentRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#deletecommentrequest)
  and
  [`DeleteCommentReplyRequest`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request#deletecommentreplyrequest).

For more information, see [Manage
comments](https://developers.google.com/workspace/sheets/api/guides/comments).

## July 13, 2026

Feature **[Developer Preview](https://developers.google.com/workspace/preview)** : The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Google Sheets is now available in developer preview. MCP is an open protocol that enables seamless integration between AI applications and your spreadsheets. By configuring the Sheets MCP server, you enable AI agents to securely interact with your spreadsheets and take actions, such as reading cell values or updating formulas.

To get started with the Sheets MCP server, see the following documentation:

- [Set up the Sheets MCP server](https://developers.google.com/workspace/sheets/api/guides/configure-mcp-server)
- [Sheets MCP tool reference](https://developers.google.com/workspace/sheets/api/reference/mcp)

To find more available MCP servers, see [Model Context Protocol (MCP) servers in Google Workspace](https://developers.google.com/workspace/guides/configure-mcp-servers).

## June 17, 2025

Feature **Generally available** : Create, update, and read Google Drive and People chips in Google Sheets API. To learn more, see [Smart chips](https://developers.google.com/workspace/sheets/api/guides/chips) in the Sheets API documentation.

## April 29, 2025

Announcement You can now create and modify tables, and take basic actions on tables using the Sheets API.

- [Learn more about creating tables using the Sheets API](https://developers.google.com/workspace/sheets/api/guides/tables)
- [Learn about the `Table` object in the Sheets API](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets#table)

## August 02, 2021

Deprecated Google Sheets API v3 is turned down. For more information, see [Migrate from Sheets API v3](https://developers.google.com/sheets/api/guides/migration).

## June 15, 2016

Announcement Google Sheets API v4 is now available. For more information, see [Introducing the Google Sheets API v4](https://cloud.google.com/blog/products/application-development/introducing-google-sheets-api-v4).