Google Drive

by w-jeon

Not rated
GitHub

About

Integrates with Google Drive to enable file listing, reading, and searching across various document formats, with OAuth authentication for secure access to user content.

Details

Author
w-jeon
Repository
w-jeon/mcp-gdrive
Categories
Productivity, Developer Tools, Design, Workplace, File Management, AI, Search, Frontend, Security, Knowledge Base, Infrastructure

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Google Drive
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @modelcontextprotocol/server-gdrive

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Create a new Google Cloud project
2. Enable the Google Drive API
3. Configure an OAuth consent screen ("internal" is fine for testing)
4. Add OAuth scope https://www.googleapis.com/auth/drive.readonly
5. Create an OAuth Client ID for application type "Desktop App"
6. Download the JSON file of your client's OAuth keys
7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. servers/gcp-oauth.keys.json)

Make sure to build the server with either npm run build or npm run watch.

To authenticate and save credentials:

1. Run the server with the auth argument: node ./dist auth
2. This will open an authentication flow in your system browser
3. Complete the authentication process
4. Credentials will be saved in the root of this repo (i.e. servers/.gdrive-server-credentials.json)

To integrate this server with the desktop app, add the following to your app's server configuration:

search

Search for files in Google Drive. Input: `query` (string): Search query. Returns file names and MIME types of matching files.

- search
- Search for files in Google Drive
- Input: query (string): Search query
- Returns file names and MIME types of matching files

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-gdrive"
    ],
    "command": "cmd"
}

Google Drive server

This MCP server integrates with Google Drive to allow listing, reading, and searching over files.

Components

Tools

- search
- Search for files in Google Drive
- Input: query (string): Search query
- Returns file names and MIME types of matching files

Resources

The server provides access to Google Drive files:

- Files (gdrive:///<file_id>)
- Supports all file types
- Google Workspace files are automatically exported:
- Docs → Markdown
- Sheets → CSV
- Presentations → Plain text
- Drawings → PNG
- Other files are provided in their native format

Getting started

1. Create a new Google Cloud project
2. Enable the Google Drive API
3. Configure an OAuth consent screen ("internal" is fine for testing)
4. Add OAuth scope https://www.googleapis.com/auth/drive.readonly
5. Create an OAuth Client ID for application type "Desktop App"
6. Download the JSON file of your client's OAuth keys
7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. servers/gcp-oauth.keys.json)

Make sure to build the server with either npm run build or npm run watch.

Authentication

To authenticate and save credentials:

1. Run the server with the auth argument: node ./dist auth
2. This will open an authentication flow in your system browser
3. Complete the authentication process
4. Credentials will be saved in the root of this repo (i.e. servers/.gdrive-server-credentials.json)

Usage with Desktop App

To integrate this server with the desktop app, add the following to your app's server configuration:

Docker

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.