01 · Overview
What the Ryze AI Google Drive MCP server is
The short version
- 01Pick Sheets, Docs and files with the Drive picker in the Ryze AI chat. The agent reads, updates or creates them, for example reading a keyword list from a Sheet or writing a report into a Doc.
- 02Three tools read (
listFiles,readFile,getSheetValues) and four write (updateSheetValues,appendSheetValues,createFile,writeDoc). There is no delete tool. - 03Ryze AI only works with files you pick or files it created. It does not search your whole Drive.
- 04Claude, ChatGPT and Cursor reach the same tools through one connector URL (see Setup).
- 05Works with any Ryze AI plan or trial. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (Google Drive tools)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over HTTP
- Client sign-in
- OAuth to Ryze AI, up to 20 workspaces per connection
- Google sign-in
- Google OAuth with the drive.file scope, one Google account per workspace
- File access
- Files you pick in the Drive picker, or files Ryze AI created
- Drive tools
- 7 (3 read · 4 write · 0 delete)
- File types
- Sheets, Docs, Slides, and text, CSV or JSON files
- Price
- Any Ryze AI plan or trial · Paid Ads $89/mo
- Checked
- November 8, 2026
People search for a Google Sheets MCP when they want an AI assistant to work in spreadsheets, and a Google Drive MCP server when they want it to work with files. The Ryze AI tools cover both for the Sheets, Docs and Slides you pick. Google also runs its own Workspace MCP servers in Developer Preview for developers, and the community hosts Drive servers on GitHub. This page documents the Ryze AI tools and compares them in section 06. Looking for the Drive API itself? That is developer work; see Google’s Drive API documentation.
01
The Drive picker sets the boundary
You choose files with + > Attach files > Upload from Drive in the Ryze AI chat. The agent sees those files and the ones it creates, and nothing else in your Drive.
02
Sheets read and write
One tool reads a range or tab, one overwrites cells (formulas allowed) and one appends rows after the last row of a table.
03
Docs get plain text
writeDoc adds text at the end of a Doc or replaces the whole document. Headings, links and formatting are not written.
04
New files on request
createFile makes a new Google Sheet, Google Doc, or text, CSV or JSON file in your Drive and returns its link. Ryze AI can then keep working in it.
05
No delete tool
The Drive tool set has no delete. The agent can overwrite cells or replace a Doc, so hold write tools for approval when a file matters.
06
Slides and text files readable
readFile returns Slides and Docs as plain text, Sheets as cell values, and text, CSV or JSON files as their content.
07
Connect from chat or from Integrations
Click Connect on the Google Drive card, or start from the file picker in chat: Ryze AI begins the connection and returns you to the picker.
08
Next to the ad tools
Google Ads, Meta Ads, GA4 and Search Console tools answer on the same URL, so one chat can pull a number and write it into a Sheet.
02 · Tool reference
Seven Google Drive tools and the picker rule
The picker rule: Ryze AI only works with files you pick in the chat composer or files it created. A file outside that set is invisible to every tool below, including when you call them from Claude or ChatGPT. In those clients the tool descriptions tell the assistant to ask you to attach the file in the Ryze AI chat. Each tool takes workspace when your client connection covers more than one Ryze AI workspace.
| Tool | Access | What it does | Inputs |
|---|---|---|---|
google_drive__listFiles | read | Lists the Google Drive files the app can access, newest first, with an optional Drive search filter. It covers picked and app-created files only. | workspace · optional filter |
google_drive__readFile | read | Reads a Drive file by ID. Sheets return cell values, Docs and Slides return plain text, and text, CSV and JSON files return their content. | workspace · file ID |
google_drive__getSheetValues | read | Reads cell values from a Google Sheet range or tab. | workspace · Sheet · range |
google_drive__updateSheetValues | write | Overwrites cell values in a Google Sheet range. Formulas are allowed. | workspace · Sheet · range · values |
google_drive__appendSheetValues | write | Appends rows after the last row of a table in a Google Sheet. | workspace · Sheet · range · values |
google_drive__createFile | write | Creates a new Google Sheet, Google Doc, or text, CSV or JSON file in your Drive and returns its link. | workspace · file type · name · content |
google_drive__writeDoc | write | Writes plain text into a Google Doc, appended at the end or replacing the whole document. | workspace · Doc · text · append or replace |
Input names are shortened here; the connector shows the exact schema to your client. Ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Google Analytics MCP.
03 · Sheets workflows
Google Sheets MCP jobs for ad teams
A spreadsheet is where many ad teams keep keyword lists. These four workflows use the Sheets and Docs tools; each starts with you picking the file.
| Workflow | How it runs |
|---|---|
| Append rows to a Sheet | Attach the Sheet and give the agent the rows to add. appendSheetValues writes them after the last row of the table and leaves existing rows alone. |
| Read a keyword list | Attach the Sheet that holds your keyword list. The agent reads the tab and uses the terms as input for a search term review or a new ad group. |
| Overwrite a range | Name the range and the new values. updateSheetValues overwrites that range only, and set write tools to approval first to review each change. |
| Write a report into a Doc | Attach a blank Doc, or ask for a new one. The agent writes the summary as plain text at the end, or replaces the text when you ask it to. |
- “Read the keyword list on the first tab and group the terms by intent.”
- “Append the rows I paste below to the end of the table on the first tab.”
- “Overwrite the range I name with the values I list below.”
- “Write a plain text summary of last month's campaigns at the end of this Doc.”
- “Create a new Sheet with the search terms we agreed to exclude and give me the link.”
- “Create a CSV file with the headlines we drafted today.”
- “Read this Doc and list the audience and offer it describes.”
- “List the files you can reach right now.”
- “Read the report sheet and tell me which rows have empty cells.”
- “Show me the cells you plan to overwrite before you change them.”
- “Append the rows but do not touch any existing cells.”
- “Replace this Doc only after I say yes.”
Every answer comes from your own files and ad accounts, so no sample output is shown here. Another connector page on the same URL is HubSpot MCP.
04 · Setup
Connect Google Drive once, then add the URL to each client
Step 1: connect Google Drive in Ryze AI
- 01In Ryze AI, open Integrations and find the Google Drive card under Files.
- 02Click Connect, sign in with Google and approve access.
- 03Or start from chat: click + (Add to message), Attach files, Upload from Drive. If Drive is not connected yet, Ryze AI starts the connection and returns you to the file picker.
- 04Pick the Sheets, Docs or files the agent should use. Only those files, and files Ryze AI creates, are reachable.
Details are in the Ryze AI Google Drive guide. A one-time connection link can also start the connection from inside Claude or ChatGPT.
Step 2: add the connector in Claude
- 01Go to Customize, Connectors.
- 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and
https://connector.get-ryze.ai/mcpas the server URL. Leave Authentication on OAuth; do not choose No sign in. - 03Click Add, then Connect. Sign in to Ryze AI, choose the workspace that holds Google Drive and click Allow connection.
- 04Start a new chat. Claude keeps the tool list it saw when the connector was added, so if Google Drive was connected afterward, remove the connector, add it again and open a new chat.
Any Claude plan works, and Free allows one custom connector. On Team and Enterprise an Owner adds the connector under Organization settings, Connectors, and each member then clicks Connect. Claude-side steps are checked against Anthropic’s custom connectors article.
ChatGPT
Add Ryze AI as a custom MCP connector: open Plugins, select the plus button, choose Add custom MCP server, name it Ryze AI, enter the URL, choose OAuth, then sign in, choose the workspace and allow the connection. OpenAI’s help article says full custom MCP support is for Business and Enterprise/Edu on ChatGPT web, and Pro gets read and fetch permissions only, which excludes the write tools on this page. It does not mention Plus. Older documentation, including parts of the Ryze AI help center, describes Settings, Apps, Developer mode instead, and the two do not agree on plans.
Claude Code
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userType /mcp, choose ryze and finish sign-in in the browser.
Cursor
{ "mcpServers": {
"ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }Cursor runs OAuth the first time a tool is used. It asks for approval before using MCP tools by default. The developer page has an Add to Cursor link and the API key option.
05 · Permissions
Who can connect, and what the drive.file scope reaches
| Scope | Google OAuth with the drive.file scope. Google describes it as non-sensitive: it covers files you open with an app or share with it through the Google Picker, plus files the app creates. |
| Who can connect | Anyone with a Google account who can sign in and approve. Ryze AI requests only the drive.file scope, never Drive-wide access. |
| Which account | One Google account per workspace. To use another account, disconnect Google Drive on its card and connect again with the other login. |
| What stays out of reach | Files you have not picked and Ryze AI did not create are invisible to the tools, including from Claude or ChatGPT. |
| Google Drive scope | Ryze AI | What Google says |
|---|---|---|
| drive.file | Used by Ryze AI | Per-file access: files opened through the picker or created by the app. Google lists it as non-sensitive and recommended. |
| drive | Not used | View and manage all Drive files. Google lists it as a restricted scope. |
| drive.readonly | Not used | View and download all Drive files. Google lists it as a restricted scope. |
Scope descriptions from Google’s Drive API authorization guide, checked Nov 8, 2026. The Ryze AI scope comes from the Ryze AI help center.
Removing access
In Ryze AI, disconnect Google Drive on its card on the Integrations page. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.
06 · Compare
Ryze AI vs Google’s own Workspace MCP servers
Three kinds of Google Drive MCP
| Option | Built for | How you connect | File reach | Changes |
|---|---|---|---|---|
| Ryze AI Google Drive tools | Marketers who want ad data and Sheets or Docs in one chat | Google sign-in in Ryze AI, then OAuth to Ryze AI from the client | Files you pick or Ryze AI created | Overwrite or append cells, write Doc text, create files; no delete |
| Google Workspace MCP servers (Developer Preview) | Developers building agents on Google's own servers | OAuth 2.0; the OAuth client needs the AI-powered agent setting enabled | Google lists Drive, Docs, Sheets, Slides, Gmail, Calendar and more | Google lists actions such as uploading files; check its tool list |
| Community Drive servers on GitHub | Developers who self-host | Varies by repo, usually your own Google Cloud OAuth client | Depends on the repo and its scopes | Depends on the repo |
Google lists remote servers for Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat, Classroom and People in the Google Workspace Developer Preview Program, most at an address of the form https://[product]mcp.googleapis.com/mcp/v1 (People uses https://people.googleapis.com/mcp/v1). See Google’s Workspace MCP servers page, checked Nov 8, 2026.
Ryze AI and Google’s servers side by side
| Ryze AI | Google Workspace MCP servers | |
|---|---|---|
| Who sets it up | You, with a Google sign-in on the Drive card and one connector URL | A developer, with a Google Cloud project and an OAuth client for an AI agent |
| File reach | Only picked or app-created files (drive.file) | Set by the scopes your OAuth client requests |
| Status | Live tools, seen on the connector on Nov 8, 2026 | Developer Preview through the Google Workspace Developer Preview Program |
| Delete | No delete tool | Check the tool list for each product |
| Other data in the same chat | Google Ads, Meta Ads, GA4, Search Console and more | Google Workspace products |
| Price | Any Ryze AI plan or trial. Paid Ads $89/mo, 7-day free trial | See Google's documentation |
As published on Nov 8, 2026. A Developer Preview can change, so check Google’s page before you decide.
Which to pick: if you are building your own agent on Google Cloud, Google’s servers are the direct route. Ryze AI fits when a marketer wants to attach a Sheet or Doc in chat, pull numbers from an ad account and write them back, with no Google Cloud project to set up. The trade-off is reach: Ryze AI cannot search your whole Drive.
07 · Limits
What the Google Drive tools cannot do
| Images | Images picked from Drive are not supported. Upload an image from your computer instead. |
| File size | Files over 10 MB are attached by name only, and the agent cannot read their content. |
| File types | Binary files and Google formats other than Sheets, Docs and Slides are attached by name only. |
| Doc writes | Plain text only: no headings, links or formatting. The text is appended at the end or replaces the whole document. |
| File reach | Picked files and files Ryze AI created. No Drive-wide search. |
| Accounts | One Google account per workspace for Drive. |
| Deleting | There is no delete tool. |
| Sheets API reads | Google's Sheets API allows 300 read requests per minute per project and 60 per minute per user per project. |
| Sheets API writes | 300 write requests per minute per project and 60 per minute per user per project. Going over returns 429 Too many requests, and Google advises exponential backoff. |
| Client plans | Claude: any plan, with one custom connector on Free. ChatGPT: custom MCP connector, see OpenAI's plan wording in the FAQ. Cursor: no plan named by Cursor. |
The first seven rows come from the Ryze AI help center. The Sheets API quotas come from Google’s Sheets API usage limits, checked Nov 8, 2026; Ryze AI does not publish how its requests count against them.
08 · Approvals and safety
How you keep control of edits
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, leave the read tools on automatic and set the write tools to Needs approval. Claude then shows each change and waits.
Approvals in the Ryze AI app
The Tool approvals picker in the Ryze AI chat starts on Skip all approvals. Approve write & delete holds every change for you; Manual approve holds more.
Overwrites are real
updateSheetValues overwrites cells and writeDoc can replace a whole Doc. There is no delete tool, but replaced content is only recoverable from Google's own version history.
Keep the picker narrow
Pick only the files the task needs. The agent cannot see the rest of your Drive.
Name the file
Say which Sheet and tab to change in the prompt, and ask the agent to show the range before it writes.
Policies
Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.
09 · Errors and fixes
Google Drive MCP errors and fixes
| Message or symptom | Cause | Fix |
|---|---|---|
| The agent cannot find my file | The file was not picked in the chat and Ryze AI did not create it, so drive.file hides it. | Click + > Attach files > Upload from Drive and pick the file. |
| Drive tools are not in Claude or ChatGPT | Google Drive was connected after the connector was added, and the client kept the old tool list. | Remove the Ryze AI connector, add it again and open a new chat. |
| Google Drive says access was revoked | Google revoked access after a password change or when the app was removed. | Reconnect on the Google Drive card in Ryze AI and approve again. |
| The card shows the wrong Google account | One Google account is allowed per workspace. | Disconnect Google Drive and connect again with the right login. |
| An image from Drive fails | Images picked from Drive are not supported. | Upload the image from your computer. |
| A file arrives by name only | It is over 10 MB, a binary file, or a Google format other than Sheets, Docs and Slides. | Export it as a Sheet, Doc, CSV or text file under 10 MB and pick that. |
| The Doc lost its formatting | writeDoc writes plain text and replacing the document drops formatting. | Ask for append instead of replace, or restore from the Doc's version history in Google. |
| Tools reply that a subscription is required | The workspace has no active Ryze AI plan or trial. | Start a plan or trial under Organization Settings, Billing, then retry. |
| 429 Too many requests from Google | The Sheets API per-minute quota was passed. | Wait a minute and ask for fewer, larger ranges. |
Rows come from the Ryze AI help center troubleshooting notes, the connector’s own behavior and Google’s Sheets API limits. More Ryze AI answers are in the integrations FAQ.
10 · FAQ
Google Drive MCP server questions
What is a Google Drive MCP server?
An MCP server lets AI clients such as Claude, ChatGPT and Cursor call Google Drive through tools. Ryze AI runs a hosted one with 7 tools that read, update and create Google Sheets, Google Docs and text, CSV or JSON files, on the same URL as its Google Ads and Meta Ads tools. Google also runs Workspace MCP servers in Developer Preview.
Is there a Google Sheets MCP?
Yes. The Ryze AI Google Drive tools work as a Google Sheets MCP: getSheetValues reads a range or tab, updateSheetValues overwrites cells (formulas allowed) and appendSheetValues adds rows after the last row of a table. They act on Sheets you pick in the Drive picker or that Ryze AI created, not on every Sheet in your account.
Can Claude read and write my Google Sheets?
Yes, through the Ryze AI connector. Connect Google Drive in Ryze AI, add https://connector.get-ryze.ai/mcp in Claude under Customize, Connectors, and attach the Sheet in the Ryze AI chat with Attach files, Upload from Drive. Claude can then read the cells, update them or append rows.
What is the Google Drive MCP server URL?
The Ryze AI server is https://connector.get-ryze.ai/mcp, the same for every account and shared with the other Ryze AI platforms. Google’s own Workspace servers mostly use addresses of the form https://[product]mcp.googleapis.com/mcp/v1, for example https://gmailmcp.googleapis.com/mcp/v1 for Gmail, and are in Developer Preview.
Can the AI see all of my Google Drive?
No. Ryze AI signs in with the drive.file scope, so it only works with files you pick in the Google Drive picker or files it created. There is no Drive-wide search, and files outside that set are invisible to the tools, including from Claude or ChatGPT.
Can it delete or edit files?
It can edit but not delete. updateSheetValues overwrites cell values, appendSheetValues adds rows, createFile makes new files and writeDoc writes plain text into a Doc, appended or replacing the whole document. There is no delete tool. In Claude, set write tools to Needs approval so each change waits for you.
What files can it read?
Google Sheets (cell values), Google Docs and Slides (plain text), and text, CSV and JSON files. Images picked from Drive are not supported. Files over 10 MB, binary files and other Google formats are attached by name only, so the agent cannot read their content.
How do I set up Google Drive MCP in ChatGPT?
Connect Google Drive in Ryze AI, then add https://connector.get-ryze.ai/mcp as a custom MCP server in ChatGPT with OAuth. OpenAI's help article lists full custom MCP support for Business and Enterprise/Edu on ChatGPT web, and read and fetch only for Pro, which blocks the write tools. It does not mention Plus. Older Ryze AI documentation describes a different plan list, so follow OpenAI's wording.
Why are the Google Drive tools missing in Claude?
Claude keeps the tool list it saw when the connector was added. If Google Drive was connected afterward, remove the Ryze AI connector, add it again and start a new chat. Connecting Google Drive first avoids the extra step.
Is the Google Drive MCP server free?
Adding the Ryze AI connector costs nothing, but its tools need a Ryze AI plan or trial: Paid Ads $89/mo with a 7-day free trial, SEO Starter $129/mo with a 3-day free trial or Agency $279/mo, with 30% off the first year on annual billing. See the pricing page.
Can I use more than one Google account?
Not at once. Drive connects one Google account per workspace. To use another account, disconnect Google Drive and connect again with the other login.
How does it compare with Google's own Workspace MCP servers?
Google's servers cover Drive, Docs, Sheets, Slides, Gmail and more, are in Developer Preview and need an OAuth client set up for an AI agent. Ryze AI is the best Google Drive MCP for reading keyword lists from Sheets and writing reports into Docs next to your ad data, because the ad tools share the connection, but it reaches only picked or app-created files.
What are the Google Sheets API limits?
Google's Sheets API allows 300 read requests and 300 write requests per minute per project, and 60 of each per minute per user per project. Going over returns 429 Too many requests, and Google advises exponential backoff. Ryze AI does not publish how its requests count against these quotas.
11 · Compatibility
Where the Google Drive tools run
12 · Related
Other integrations and guides
Changelog
Page checked Nov 8, 2026. First version. Tool list, picker rule, limits and setup steps were checked against the Ryze AI connector and help center. Scope, Workspace MCP server and Sheets quota statements were checked against developers.google.com, and the Claude steps against support.claude.com.