Google Drive MCP Server (Apify Actor)

A secure and extensible Google Drive MCP (Machine Control Protocol) Server built using Apify Actors.
This Actor enables AI agents, automation workflows, and applications to safely list, search, and read Google Drive files using user-provided credentials — without storing any secrets.

---

🚀 What does this Actor do?

This Actor provides a secure API layer on top of Google Drive that allows controlled, on-demand access to Drive data.

It allows users or AI systems to:

• Browse Google Drive folders
• Search files using Google Drive queries
• Read file content programmatically

All access is granted only for the duration of a single run, using credentials supplied by the user.

---

🎯 Main Purpose

AI systems and automation tools often need access to documents stored in Google Drive, but:

• Users don’t want to permanently share credentials
• Developers don’t want to hard-code API keys
• OAuth flows are complex for automation
• AI tools need structured JSON outputs, not UI-based access

✅ This Actor solves all of the above by acting as a stateless Google Drive MCP server, designed for AI-first workflows.

---

🧠 How it Works (High-level Architecture)

1. The user provides:
   • A Google Service Account JSON
   • An operation (listFiles, searchFiles, or getFileContent)
   • Optional parameters (folderId, query, fileId)
2. The Actor:
   • Authenticates using the provided service account
   • Connects to Google Drive API v3
3. The requested operation is executed
4. Results are returned as structured JSON
5. Output is stored in an Apify Dataset for easy API or AI consumption

✅ No credentials are stored
✅ Each run is isolated and secure

---

🔐 Security & Privacy

• No API keys are hard-coded
• Credentials are supplied per run
• Data access is limited to folders/files explicitly shared with the service account
• Uses drive.readonly scope (least privilege)
• No data or secrets persist after execution

---

🔧 Supported Operations

---

1️⃣ listFiles

List files from a Google Drive folder (or root).

Use Case

• Browse folder contents
• Let AI understand what files exist before taking action

Required Input

• operation: "listFiles"
• serviceAccountJson

Optional Input

• folderId: Google Drive folder ID
• pageSize: Maximum number of results

Output Example

{
  "operation": "listFiles",
  "folderId": "FOLDER_ID",
  "files": [
    {
      "id": "1abc123",
      "name": "ProjectNotes.pdf",
      "mimeType": "application/pdf",
      "webViewLink": "https://drive.google.com/file/d/1abc123/view",
      "modifiedTime": "2025-11-27T16:59:29Z"
    }
  ]
}