By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Cursor to Google Drive, connect Google Drive in Ryze AI with your Google sign-in, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json, and sign in when Cursor asks.
- In Ryze AI open Integrations, find Google Drive and click Connect
- Sign in with Google and approve access
- In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
- In Ryze AI chat pick your files with + > Attach files > Upload from Drive, then ask Cursor
Before you start
- A Cursor install. Cursor's MCP documentation names no plan for using MCP servers. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
- A Google account for Drive. Ryze AI asks for the drive.file scope, so it only works with files you pick in the Google Drive picker or files it created. It does not browse the rest of your Drive. Drive connects one Google account per workspace.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; SEO Starter is $129 per month with a 3-day free trial. Adding the connector is free, but the Google Drive tools need an active plan or trial.
How to connect Cursor to Google Drive
Two steps happen in Ryze AI and Google, two in Cursor, and two when you pick files and ask. The connector URL is the same for every user.
Connect Google Drive in Ryze AI
Create a Ryze AI account or sign in, open Integrations, find the Google Drive card under Files and click Connect. You can also connect from chat: click + (Add to message), then Attach files, then Upload from Drive. If Drive is not connected yet, Ryze AI starts the connection and returns you to the file picker.
Sign in with Google and approve access
Sign in to the Google account that owns the files and approve the request. The scope is drive.file, so Ryze AI can only work with files you pick and files it creates.
Add the Ryze AI server to Cursor
Either use the Add to Cursor link on the Ryze AI developers page, which opens a cursor:// install link for a server named ryze at https://connector.get-ryze.ai/mcp, or create ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) with the url entry shown below.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Sign in from Cursor
Confirm the install in Cursor. Cursor runs OAuth with PKCE and dynamic client registration, so there is no client ID or secret to enter. Sign in on the Ryze AI page and click Allow connection. You can manage or toggle the server from the Customize page in the sidebar.
Pick the files Cursor can use
In Ryze AI chat click + > Attach files > Upload from Drive and choose the Sheets, Docs or files you want to work with. Files outside the picker, and files Ryze AI did not create, are invisible to the Drive tools, including from Cursor.
Ask your first question in Cursor
Start a new chat in Cursor, approve the tool call when Cursor asks, and try: Read the Google Sheet I picked and list its tab names and the header row of each tab.
The Ryze AI help center page for Google Drive covers the Drive side of the connection. Cursor does not have its own Ryze AI help page; the Ryze AI developers page has the Add to Cursor link and the matching config.
Sources: Cursor MCP documentation, Ryze AI Google Drive guide. Checked November 10, 2026.
mcp.json, API key and Cloud Agents
mcp.json
Save this as ~/.cursor/mcp.json for every project or .cursor/mcp.json for one project. Cursor accepts remote servers through the url field and handles the OAuth sign-in itself.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Cursor supports stdio, SSE and Streamable HTTP transports. For OAuth it reads the server's protected resource metadata (RFC 9728) and registers as a public client through dynamic client registration. After sign-in, manage or toggle the server from the Customize page in the sidebar.
mcp.json with a Ryze AI API key
If you prefer a key to the browser sign-in, add a headers entry and set RYZE_API_KEY in your environment to the rk_live_ key from Ryze AI under Workspace Settings > Profile > API keys. Keep the key out of files you commit.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:RYZE_API_KEY}"
}
}
}
}Cloud Agents
Cursor Cloud Agents keep their own MCP sign-ins on Cursor's servers, separate from the sign-in on your desktop. If a Cloud Agent needs Google Drive, connect the Ryze AI server for it as well.
Claude and ChatGPT
The same URL works in other MCP clients. Google Drive is connected once in Ryze AI, so nothing changes on the Google side.
Claude
Add https://connector.get-ryze.ai/mcp as a custom connector under Customize > Connectors, pick the workspaces and start a new chat.
ChatGPT
Add the same URL as an app under Settings > Apps, pick the workspaces and start a new chat. If the connector was added before Google Drive was connected in Ryze AI, remove and re-add it so the tool list refreshes.
Google Drive access and scope
Two sign-ins are involved: Google for Drive access and Ryze AI for the connector. Three things decide what Cursor can reach.
- Which files
- Only files you pick in the Google Drive picker and files Ryze AI created. The picker is in the Ryze AI chat composer, so Cursor cannot browse your Drive or open an arbitrary file ID.
- Which account
- Drive connects one Google account per workspace. To use another account, disconnect Drive and connect again.
- What Cursor asks first
- Cursor asks for approval before using MCP tools by default and follows the same Run Modes as terminal commands, so a Sheet update or a Doc write waits for your click unless you allowlist the tool.
The Google scope
Ryze AI requests a single Google scope.
| Action in Ryze AI | Google scope |
|---|---|
| Read picked files | drive.file (files you pick or Ryze AI created) |
| Update Sheets and write Docs | drive.file (the same scope) |
| Create new files | drive.file (files Ryze AI creates become visible to it) |
Removing access
To remove access, disconnect Google Drive on its card in Ryze AI, or remove the app from your Google account's connected apps. In Cursor, toggle the ryze server off from Customize or delete its entry from mcp.json.
What Cursor can do in Google Drive
The Ryze AI connector exposes seven Google Drive tools: three read, four write. There is no delete tool.
| Tool | Type | What it does |
|---|---|---|
| google_drive__listFiles | Read | Lists the Google Drive files the app can access, newest first, with an optional Drive search 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. |
| google_drive__getSheetValues | Read | Reads cell values from a Google Sheet range or tab. |
| google_drive__updateSheetValues | Write | Overwrites cell values in a Google Sheet range; formulas are allowed. |
| google_drive__appendSheetValues | Write | Appends rows after the last row of a table in a Google Sheet. |
| google_drive__createFile | Write | Creates a new Google Sheet, Google Doc, or text, CSV or JSON file in your Drive and returns its link. |
| google_drive__writeDoc | Write | Writes plain text into a Google Doc, either appended at the end or replacing the whole document. |
Some limits apply to every client, Cursor included. Images picked from Drive are not supported. Files over 10 MB, binary files and Google formats other than Sheets, Docs and Slides are attached by name only. Doc writes are plain text, with no headings, links or formatting, and either append at the end or replace the whole document.
Cursor asks before it runs an MCP tool by default. Keep that default if you want to review each Sheet update and Doc write. Separately, the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals; you can choose Approve write & delete or Manual approve there.
First 3 prompts to run
1. Read a keyword list from a Sheet
Read the Google Sheet I picked that holds my keyword list. Show the tab names and the header row, then list the keywords from the first column.
Tools used: google_drive__listFiles, google_drive__getSheetValues
What comes back: The tab names, the header row and the keyword column as plain text in Cursor. The Sheet is not changed.
2. Write a report into a Doc
Create a new Google Doc named Weekly report draft and write a short plain-text summary of this conversation into it. Give me the link.
Tools used: google_drive__createFile, google_drive__writeDoc
What comes back: A link to the new Doc with the summary as plain text. Headings and formatting are not applied because Doc writes are plain text only.
3. Add rows to a Sheet
Append these three rows to the table in the Google Sheet I picked, matching the existing column order, and tell me which range was written.
Tools used: google_drive__getSheetValues, google_drive__appendSheetValues
What comes back: Cursor reads the current columns, appends the rows after the last row of the table and reports what it wrote.
Each answer comes from your own files, so this page describes what comes back instead of showing sample data. Pick the files in Ryze AI chat before you run a prompt in Cursor.
Ryze AI vs Google's Drive MCP server
Google also documents its own Google Drive MCP server. The two suit different setups.
| Option | Setup | Drive coverage | Access |
|---|---|---|---|
| Ryze AI connector | Connect Drive in Ryze AI, then add one URL to Cursor (Add to Cursor link or mcp.json). OAuth with PKCE and dynamic client registration, no client ID to create | 7 tools: list, read, read and update Sheet values, append rows, create files, write Docs. No delete | drive.file only: files you pick or Ryze AI created |
| Google Drive MCP server (Google) | Add https://drivemcp.googleapis.com/mcp/v1 to the client with OAuth client credentials. Listed as part of the Google Workspace Developer Preview Program | 8 tools: copy_file, create_file, download_file_content, get_file_metadata, get_file_permissions, list_recent_files, read_file_content, search_files | OAuth scopes drive.readonly and drive.file |
Google's server lists search_files and list_recent_files and uses the broader drive.readonly scope, so it can look across your Drive. The Ryze AI connector cannot search your whole Drive, but it can update Sheet cells, append rows and write into Docs, and it needs no Google Cloud OAuth client from you. Pick Google's server for read and search across Drive if you are in the preview program; pick the Ryze AI connector to edit picked Sheets and Docs from Cursor.
Sources: Google Workspace MCP servers, Cursor MCP documentation, Ryze AI Google Drive guide. Checked November 10, 2026.
Cursor and Google Drive errors and fixes
- Cursor cannot see my file
- The Drive tools only reach files you picked and files Ryze AI created. In Ryze AI chat use + > Attach files > Upload from Drive to pick it, then ask again.
- The Google Drive tools do not appear in Cursor
- If Drive was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new chat so the tool list refreshes.
- Cursor never asks me to sign in
- Open Customize in the sidebar, find the ryze server and reconnect it. Cursor reads the connector's protected resource metadata and registers itself, so no client ID is needed.
- A Cloud Agent cannot use Drive
- Cloud Agents keep their own MCP sign-ins on Cursor's servers. Connect the Ryze AI server for the agent separately from your desktop.
- The server is blocked on a team account
- Enterprise admins can allowlist which servers and tools the team may run. Ask an admin to allow the Ryze AI server in Team Settings > MCP Configuration.
- A file is attached by name only
- Files over 10 MB, binary files and Google formats other than Sheets, Docs and Slides are attached by name only, so Cursor cannot read their content.
- A Doc lost its formatting
- Doc writes are plain text only, and the write either appends or replaces the whole document. Ask Cursor to append to keep existing text.
- The wrong Google account is connected
- Drive connects one Google account per workspace. Disconnect Google Drive in Ryze AI and connect it again with the right account.
- The tools reply that a subscription is required
- The Google Drive tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Cursor to Google Drive?
Connect Google Drive in Ryze AI under Integrations, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link on the Ryze AI developers page or a url entry in mcp.json. Sign in when Cursor asks, then pick your files in Ryze AI chat.
Is there a Google Drive MCP server for Cursor?
Two options exist. Google documents a Google Drive MCP server at https://drivemcp.googleapis.com/mcp/v1 in its Workspace Developer Preview Program, with 8 tools and OAuth scopes drive.readonly and drive.file. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 7 Drive tools, including Sheet and Doc writes.
Which should I use, Ryze AI or Google's Drive server?
Ryze AI is the best way to connect Cursor to Google Sheets and Docs you pick, but it only reaches files you pick or that it created. Google's server searches across Drive with a broader read scope, and you need to be in its preview program.
Can Cursor search my whole Google Drive?
Not through the Ryze AI connector. It uses the drive.file scope, so it only sees files you pick in the picker and files it created. It does not browse your Drive on its own.
Can Cursor edit Google Sheets and Docs?
Yes, for files you picked or Ryze AI created. It can overwrite cell values, append rows, create new Sheets, Docs and text, CSV or JSON files, and write plain text into a Doc. It cannot delete files, and Doc writes carry no formatting.
Which Cursor plan do I need?
Cursor's MCP documentation names no plan. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration.
Does Cursor ask before changing a Sheet?
By default, yes. Cursor asks for approval before using MCP tools and follows the same Run Modes as terminal commands. You can allowlist tools if you want them to run without a prompt.
Where do I pick the files?
In the Ryze AI chat composer: click + > Attach files > Upload from Drive. The picker is not available inside Cursor, so pick files there before asking Cursor to use them.
Can I use a Ryze AI API key instead of the browser sign-in?
Yes. Add a headers entry with Authorization set to Bearer followed by your rk_live_ key from Workspace Settings > Profile > API keys, and keep the key in an environment variable such as RYZE_API_KEY.
Can I connect more than one Google account?
Drive connects one Google account per workspace. To use another account, disconnect Drive and connect it again.
How much does it cost to connect Cursor to Google Drive?
Adding the connector costs nothing, but the Google Drive tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year.
How do I disconnect Google Drive from Cursor?
Toggle the ryze server off from Customize in Cursor or remove its entry from mcp.json. To remove Drive access itself, disconnect Google Drive on its card in Ryze AI.