What Is Google Drive MCP Server?

Google Drive MCP Server is a Model Context Protocol server that lets Claude browse, read, and search files stored in Google Drive. It is maintained by the Model Context Protocol team under the official modelcontextprotocol/servers monorepo.


Quick Facts

FieldValue
Package@modelcontextprotocol/server-gdrive
Installnpx @modelcontextprotocol/server-gdrive
Compatible withClaude Desktop
StatusActive
GitHubgithub.com/modelcontextprotocol/servers/tree/main/src/gdrive

What You Can Do With It

  • File reading: Open and read the contents of documents stored in your Google Drive directly within a Claude conversation.
  • Document search: Query across your Drive to locate files by name or content without leaving the Claude interface.
  • Spreadsheet access: Read data from Google Sheets files, making tabular data available for analysis or summarization.
  • Content extraction: Pull text content out of Drive-hosted files, including Google Docs and other supported formats, for use in prompts or downstream tasks.

How to Set It Up

Prerequisites: You need a Google Cloud project with the Drive API enabled and OAuth 2.0 credentials configured. Download your credentials.json from the Google Cloud Console before proceeding.

1. Install the package (optional local install):

npm install -g @modelcontextprotocol/server-gdrive
**2. Run the OAuth flow** to generate a token:
```bash
npx @modelcontextprotocol/server-gdrive

On first run, the server will prompt you to authorize access via a browser window. The resulting token is stored locally for subsequent use.

3. Add the server to your Claude Desktop config.

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on Windows, and add the following under mcpServers:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-gdrive"
      ]
    }
  }
}

Restart Claude Desktop after saving the file. The Drive tools will appear as available in the MCP tools panel.


Works Best With

Google Drive MCP Server is documented for use with Claude Desktop. It is not currently listed as compatible with Claude Code (the CLI) or other third-party MCP clients. If you are running a non-Desktop Claude environment, verify MCP tool support before attempting integration.


Known Limitations

  • OAuth requirement: This server requires a full Google OAuth 2.0 setup. There is no API-key-only path. First-time configuration involves creating a Cloud project, enabling the Drive API, and completing a browser-based consent flow.
  • Token storage: The OAuth token is stored locally. If the token expires or is revoked, you will need to re-authorize.
  • Read-only scope: Based on documented use cases, the server supports reading and searching files. Write operations (creating, editing, or deleting files) are not listed as supported features.
  • File format support: Not all file types in Drive may be extractable as plain text. Binary formats or files without a Google Workspace equivalent may not return readable content.
  • Rate limits: The server is subject to Google Drive API quota limits. Heavy usage or large Drive accounts may encounter throttling from Google’s side.
  • No shared drive support confirmed: Behavior with Google Shared Drives (formerly Team Drives) is not explicitly documented; test against your specific setup.

Community Resources

This article contains affiliate links. We may earn a commission at no extra cost to you. Learn more.

Share: X