PopMCP
google_drive_Creates a copy of a file and applies any requested updates with patch semantics.
Google Drive MCP server for your AI
Search files, read and rewrite their contents, move things between folders, share or unshare a document, and pull the comment thread and revision history behind any file.
PopMCPGoogle Drive
Which files did I touch this week, and who commented on them?
Supported Google Drive tools
Every file, folder, shared drive, comment, permission and revision operation this connection exposes, plus the Drive events it can watch.
google_drive_Creates a file.
google_drive_Create a folder.
google_drive_Gets a file's metadata or content by ID.
google_drive_List the files this account touched most recently, newest first — the answer to "what have I been working on?" or "find the doc I edited yesterday".
google_drive_Move a file or folder into a different folder.
google_drive_Exports a Google Workspace document to the requested MIME type and returns exported byte content.
google_drive_Lists the user's files.
google_drive_Downloads the content of a file.
google_drive_Move a file or folder to the trash — the SAFE way to delete.
google_drive_Restore a file or folder from the trash back to its original location.
google_drive_Updates a file's metadata, content, or both.
google_drive_Gets a shared drive's metadata by ID.
google_drive_Lists the user's shared drives.
google_drive_Creates a comment on a file.
google_drive_Creates a reply to a comment.
google_drive_Lists a file's or shared drive's permissions.
google_drive_Lists a file's comments.
google_drive_Lists a comment's replies.
google_drive_Deletes a permission.
google_drive_Creates a permission for a file or shared drive.
google_drive_Updates a comment with patch semantics.
google_drive_Updates a permission with patch semantics.
google_drive_Gets a revision's metadata or content by ID.
google_drive_Lists a file's revisions.
google_drive_Create a NEW file with its content in a single call — the normal way to write anything to Drive.
google_drive_Download the raw CONTENT of a binary/uploaded file (alt=media) — a .txt, .md, .csv, .json, .xml, .html or source-code file stored in Drive.
google_drive_Gets the starting pageToken for listing future changes.
google_drive_List the access proposals on a file.
google_drive_Lists the changes for an user or shared drive.
google_drive_Approves or denies an access proposal.
google_drive_REPLACE the entire content of an existing file, keeping its id, location, sharing and comments.
google_drive_Gets information about the user, the user's Drive, and system capabilities.
google_drive_Gets the latest state of a long-running operation.
google_drive_Permanently deletes a file owned by the user without moving it to the trash.
google_drive_Permanently deletes all of the user's trashed files.
google_drive_Generates a CSE token which can be used to create or update CSE files.
google_drive_Generates a set of file IDs which can be provided in create or copy requests.
google_drive_Lists the labels on a file.
google_drive_Modifies the set of labels applied to a file.
google_drive_Subscribes to changes to a file.
google_drive_Approves an approval.
google_drive_Cancels an approval.
google_drive_Comments on an approval.
google_drive_Declines an approval.
google_drive_Gets an approval by ID.
google_drive_Lists the approvals on a file.
google_drive_Reassigns the reviewers on an approval.
google_drive_Starts an approval on a file.
google_drive_Creates a shared drive.
google_drive_Permanently deletes a shared drive for which the user is an `organizer`.
google_drive_Hides a shared drive from the default view.
google_drive_Restores a shared drive to the default view.
google_drive_Updates the metadata for a shared drive.
google_drive_Deletes a comment.
google_drive_Gets a comment by ID.
google_drive_Gets a permission by ID.
google_drive_Deletes a reply.
google_drive_Gets a reply by ID.
google_drive_Updates a reply with patch semantics.
google_drive_Permanently deletes a file version.
google_drive_Updates a revision with patch semantics.
google_drive_Subscribes to changes for an user.
google_drive_Retrieves an access proposal by ID.
google_drive_Gets a specific app.
google_drive_Stops watching resources through this channel.
Connect Google Drive to your AI
Authorize once, then an endpoint your client signs into. Nothing to deploy, and nothing to install on the Google Drive side.
Enable the Google Drive API in your Google Cloud project, paste the OAuth Client ID and OAuth Client Secret, and authorize once. The connection sees exactly what that Google account sees — authorize with a narrower one.
OAuth Client ID
1234567890-abc.apps.googleusercontent.comOAuth Client Secret
••••••••••••3f7aAuthorize PopMCP on Google DriveAuthorize
Read-only keeps the agent to search and reading. On full access, turn on approval for writes so permanent deletes, emptying the trash and permission changes wait for a yes. The full catalog toggle exposes the rest.
Full accessRead-only
Expose full catalog
Approval required for writes
Drop the PopMCP URL into Claude, ChatGPT, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Google Drive credential never leaves the server.
app.popmcp.com/mcp/…
Claude wants to connectApproveAsk for something harmless before you turn writes on. Once it comes back clean, widen the tool set or switch the connection to full access.
Which files did I touch this week, and who commented on them?
google_drive_list_recent_filesok
Then just ask for the work
“Which files did I touch this week, and who commented on them?”
- list_recent_files
- list_comments
- list_replies
“Move every 2023 invoice PDF out of Inbox into the Archive folder”
- search_files
- get_file_metadata
- move_file
“Draft a Q3 retro doc in the Team Notes folder and share it with Priya”
- search_files
- create_file
- share_file
“Who still has edit access to the pricing deck, and when was it last revised?”
- search_files
- get_file_permissions
- list_revisions
Use Google Drive from the assistant you already open
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Claude DesktopCustom connector
Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.
Claude WebCustom connector
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
ChatGPTCustom connector
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
CodexDesktop & CLI
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
OpenCodeCoding agent
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
ZCodeDesktop app
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
Explore other MCP servers
Every one of them runs on the same hosted endpoint, with the same controls.
FAQ
Google Drive MCP server questions
What teams ask before putting Google Drive behind an AI client.
Can I point the connection at a single folder?
No — there is no folder or drive ID to look up during setup. The connection reaches exactly what the Google account you authorize with can reach, so the way to narrow it is to authorize with an account that only has the access you want to give. Setting the connection to read-only narrows what it can do rather than what it can see.
Do I need my own Google Cloud OAuth client?
Yes. You enable the Google Drive API in your own Google Cloud project, then paste the OAuth Client ID and OAuth Client Secret into the connect form and authorize once. Nothing else gets pasted afterwards — no API key, no service account file, and no token in your prompts.
Why does the connection stop working after about a week?
Check your Google Cloud project's Audience. If it is set to External, you have to publish the app before you connect — otherwise Google expires the authorization after 7 days and the agent starts failing. Publish first, then connect.
Can it read what is inside a Google Doc, or only the file list?
It reads the contents. read_file_content exports a Google Workspace document to the MIME type you ask for and returns the exported bytes, while download_file_content pulls the raw content of an uploaded file such as a .txt, .md, .csv, .json, .xml, .html or source-code file. update_file_content replaces the entire content of an existing file while keeping its ID, location, sharing and comments intact.
Can the agent permanently delete my files?
trash_file is the safe delete — it moves a file or folder to the trash, and untrash_file puts it back where it came from. delete_file_permanently and empty_trash also exist and are not recoverable, which is exactly the pair to hold behind approval-required-for-writes, or to rule out entirely with read-only access.
Does it work with shared drives or just My Drive?
Shared drives are covered. list_shared_drives lists the shared drives on the account and get_shared_drive pulls one by ID, get_file_permissions and share_file work on a shared drive as well as a single file, and list_changes can follow changes for a user or a shared drive. Which shared drives appear still depends on the Google account you authorized with.
Do I have to run or host the Google Drive MCP server myself?
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Which AI clients can use this MCP server?
Any client that supports a remote Streamable HTTP MCP server — Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
Why do only 34 of the 66 tools load by default?
Loading 66 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 34-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. You can switch a connection to the full catalog at any time.
What is the difference between a tool and a trigger?
A tool is something your AI calls — there are 66 here. A trigger is something PopMCP watches for you: 12 Google Drive events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Google Drive.
Connect Google Drive to your AI in minutes
Launch a hosted MCP endpoint for Google Drive, keep tool access under control, and start testing real workflow prompts right away.