Mcp Google Drive
MCP server for the Google Drive API: search, upload, download, organize and share files.
- Transport
- Not stated
- Package
- —
- Registry id
- io.github.A1-x-Tech/mcp-google-drive
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
English | Русский
A1 Google Drive MCP lets an AI app work with your Google Drive in plain language. Find a file, tidy up folders, upload and download content, export a Doc as Markdown, share it with the right people — and keep the trash between you and permanent deletion.
It uses the Google Drive API with your Google account. It sees My Drive and shared drives alike, treats “delete” as the reversible trash and makes the limits of the Drive API explicit instead of implying that every file task is possible.
- 15 tools. Search and metadata, folders and moving, upload and download, export of Docs/Sheets/Slides, the trash, sharing and comments.
- The trash comes first. “Delete” means the reversible trash; permanent deletion is a deliberately separate tool that cannot be picked by accident.
- Documents stay intact. Docs, Sheets and Slides move, copy, export and convert as whole files — the server never edits the text inside them.
- You choose the scope.
drive.readonlycovers every read anddrive.filelimits access to app-created files; the full tool surface needsdrive.
Start with a read-only question:
Find the project roadmap doc in my Drive, export it to Markdown and summarize it.
Connect the server · Explore use cases · Open technical documentation
See it work in a minute
You: Show me what’s in the “Contracts 2025” folder, newest first.
Assistant: Lists the files with their types, owners and modification dates. Nothing changes.
You: Prepare an “Archive” subfolder and move everything older than a year into it.
Assistant: Shows the folder it would create and the files it would move, then asks for confirmation.
You: Confirm.
Assistant: Creates the folder and moves the files. Nothing is shared, trashed or deleted unless you ask separately.
Contents
- Quick start
- What you can ask it to do
- How your Drive changes
- What can change
- Getting access
- Configuration
- Data, limits and background work
- Technical documentation
- Support
Quick start
You need Node.js 20+, a Google account and OAuth credentials from a Google Cloud project with the Google Drive API enabled.
- Prepare Google OAuth access.
- Add the server to your AI app.
- Ask the read-only question above.
Codex
In the desktop app: open Settings → MCP servers, select Add server, choose STDIO, and enter the command npx -y @a1-x-tech/mcp-google-drive@latest with GOOGLE_DRIVE_CLIENT_ID, GOOGLE_DRIVE_CLIENT_SECRET and GOOGLE_DRIVE_REFRESH_TOKEN. Select Save, then Restart.
In the IDE extension: open the gear menu → MCP servers, select Add server, choose STDIO, and enter the same command and environment variables. Select Save, then Restart extension.
From the command line:
codex mcp add google-drive \
--env GOOGLE_DRIVE_CLIENT_ID=your_client_id \
--env GOOGLE_DRIVE_CLIENT_SECRET=your_client_secret \
--env GOOGLE_DRIVE_REFRESH_TOKEN=your_refresh_token \
-- npx -y @a1-x-tech/mcp-google-drive@latest
From the project's README.