@botrun/mcp-google-drive

MCP (Model Context Protocol) server for Google Drive integration. List files, read content from Google Docs, Sheets, and Slides.

Features

• 📁 List Drive Files - List all files in a Google Drive folder
• 📄 Get File Content - Read content from Google Docs, Sheets, Slides, and other text files
• 🔓 Public Access - Access public files without credentials
• 🔐 Private Access - Access private files with Service Account

Installation

npm install -g @botrun/mcp-google-drive

Or use with npx:

npx @botrun/mcp-google-drive

Setup in Cursor / Claude Desktop

Add to your MCP configuration file:

For Public Files Only (No credentials needed)

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["@botrun/mcp-google-drive"]
    }
  }
}

For Private Files (Requires Service Account)

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["@botrun/mcp-google-drive"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"
      }
    }
  }
}

Getting Service Account Credentials

1. Go to Google Cloud Console
2. Create or select a project
3. Enable the Google Drive API
4. Go to Credentials → Create Credentials → Service Account
5. Create the service account and download the JSON key file
6. Share your Google Drive folder/files with the service account email

Available Tools

list-drive-files

List all files in a Google Drive folder.

Input:

• url (required): Google Drive folder URL

Example:

List files in https://drive.google.com/drive/folders/xxxxx

get-drive-file-content

Get the content of a single file.

Input:

• fileUrl (required): Google Drive file URL or file ID

Supported formats:

• Google Docs → Plain text
• Google Sheets → CSV
• Google Slides → Plain text
• Other text files → Raw content

Example:

Read content from https://docs.google.com/document/d/xxxxx/edit

Output Format

All responses follow a consistent JSON format:

{
  "isSuccess": true,
  "result": {
    "message": "Description"
    // ... data
  }
}

Environment Variables

| Variable | Required | Description | | -------------------------------- | -------- | ------------------------------------- | | GOOGLE_APPLICATION_CREDENTIALS | No | Path to Service Account JSON key file |

License

MIT