Google Drive server

Components

Tools

• search
  • Search for files in Google Drive
  • Input:

    query

    (string): Search query
  • Returns file names and MIME types of matching files

Resources

• 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

   )

npm run build

npm run watch

Authentication

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

Docker

/path/to/gcp-oauth.keys.json

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

mcp-gdrive

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "mcp-gdrive:/gdrive-server", "-e", "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json", "mcp/gdrive"]
    }
  }
}

NPX

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

License