SkillFoxx

Google Drive MCP

A self-hosted MCP server for Google Drive, Docs, Sheets, Slides and Calendar: 130 tools and per-call account selection

  • 235 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The agent reads, edits and deletes files in Drive, changes sharing and creates calendar events with your rights
  • OAuth tokens sit on disk and open the Drive, Docs, Sheets, Slides and Calendar of your account
All reasons and checks

piotr-agier/google-drive-mcpAuthor:piotr-agier

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/google-drive-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The agent reads, edits and deletes files in Drive, changes sharing and creates calendar events with your rights
  • OAuth tokens sit on disk and open the Drive, Docs, Sheets, Slides and Calendar of your account

This is third-party code. Review the repository files before installing.

What it does

The server connects an MCP client to Google Drive, Docs, Sheets, Slides and Calendar. The agent searches and organizes files, creates and edits documents, formats spreadsheets, writes presentations, manages file sharing and creates calendar events with a Google Meet link. There are 130 tools in all: files, shared drives, permissions, revisions, rich Docs editing, Sheets formatting, Slides and Calendar events. There is also a `gdrive:///` resource interface for direct reading. The server has three modes: stdio for a personal client, Streamable HTTP for a hosted integration and a team mode with OAuth 2.1 for a shared service. Local sign-in supports several Google accounts and the account can be chosen per call, and service accounts and externally issued tokens are also possible. Credentials and tokens stay where you run the server. Tokens are stored by default in `~/.config/google-drive-mcp/tokens.json`.

Who it is for. People who keep reports, presentations and a calendar in Google Workspace and want to hand routine work to an agent on their own credentials.

Good fit when

  • Find PDFs in the Reports folder, create an Archive folder and move files older than a year into it
  • Build a spreadsheet of monthly results, write a summary in Docs and make a short presentation from it
  • In the Project Plan document replace the launch date, make it bold and leave a comment describing the change
  • Create a calendar event with a Google Meet link and attach the brief from Drive

Not a fit when

  • You need other Google Workspace products: the server focuses on Drive, Docs, Sheets, Slides and Calendar
  • The agent must not be allowed to change and delete files: the tools include writing, sharing and revisions
  • You have no Google Cloud project: sign-in needs OAuth credentials of the Desktop type

Example request

Find files in Drive modified in the last seven days and show a list with the owner and date, changing nothing

MCP

Transport
stdio, http
Authentication
OAuth

Limitations

Running needs a Google Cloud project with the Drive, Docs, Sheets, Slides and Calendar APIs enabled, an OAuth consent screen and a Desktop-type client; the key file is saved as `~/.config/google-drive-mcp/gcp-oauth.keys.json`, then `npx -y @piotr-agier/google-drive-mcp auth` is run. While the app is in testing mode your own account is added as a test user. Team mode needs `--team`, HTTP mode and a public HTTPS `--issuer-url`. The server intentionally does not cover every Workspace API. Retries on 429, 503 and 504 errors are on, three by default.

How to disable. Remove the google-drive block from the client config, delete `~/.config/google-drive-mcp/tokens.json` and revoke the app's access on your Google account security page.

FAQ

How do I connect Google Drive MCP?

Get OAuth credentials in Google Cloud, run `npx -y @piotr-agier/google-drive-mcp auth`, then add a server with the `npx` command and the arguments `-y`, `@piotr-agier/google-drive-mcp` to the client and restart the client.

How do I check which account is active?

Ask the agent to run `authGetStatus`: the tool names the active Google account. With several accounts it can be chosen per call.

Which transport modes are there?

stdio for a personal desktop client, Streamable HTTP for a hosted integration (port 3100 by default) and a `--team` mode with OAuth 2.1 for a shared service.

Where are tokens stored?

By default in `~/.config/google-drive-mcp/tokens.json` on the machine running the server. Credentials and tokens do not leave the environment you control.

Can the gdrive resources be limited?

Yes, the `--no-resources` flag turns off the `gdrive:///` interface and leaves tools enabled.

Discussion

No questions or reviews yet.

MCP servers

A local document base for your agent: hybrid semantic and keyword search plus a web UI for browsing and uploads

MCP serverExtended access346

An MCP server to create and edit Excel files without Microsoft Office: formulas, formatting, charts, pivot tables

MCP serverExtended access4.3K

Launchstack MCP updates a saved conversation using its previous identifier so a continuation does not create another copy.

MCP serverExtended access897

An MCP server that turns PDF, DOCX, XLSX, PPTX, images, audio, web pages and YouTube transcripts into Markdown

MCP serverExtended access3K
Official

The MCP server lets agents read and search local Molio vaults, browse file trees and ask questions about their contents.

MCP serverExtended access448

README in short

The text describes the server as a single point of connection to Drive and Google editors while keeping control of credentials. Next come a client compatibility table, a quick start with creating OAuth credentials, first calls, scenario examples and a list of guides: authentication, configuration, deployment, tools.

README badge

Report a problem