Google Drive MCP

Overview

Google Drive MCP memungkinkan AI agent membaca, mengedit, dan mencari file Google Drive, Docs, Sheets, dan Slides atas nama kamu — menggunakan akun @qiscus.com kamu sendiri. Setup satu kali, access token otomatis refresh, tidak perlu login ulang.

Hanya untuk akun Google Workspace @qiscus.com. Akun Gmail pribadi tidak diizinkan.

Capabilities

Install Steps

Sebelum Mulai

Pastikan kamu punya:

• Akun Google Workspace @qiscus.com
• Claude Desktop ter-install — download
• Node.js v18+ ter-install — cek dengan node --version. Belum ada? Install dari nodejs.org (pilih LTS)

1. Login & Download File Setup

Buka browser ke: https://gdrive-mcp-auth.qiscus.io

Klik “Login dengan Google” → pilih akun @qiscus.com → klik Allow di semua permission.

Penting: klik Allow di semua scope. Menolak salah satu scope akan membuat refresh token tidak diberikan dan setup gagal.

Setelah login, halaman setup menampilkan 3 tombol download:

Saran: klik “Download setup ZIP” — sekali klik dapat semua. Sesi setup berlaku 10 menit — selesaikan langkah berikutnya sebelum sesi berakhir.

2. Pindahkan File ke Folder Install

Pilih sesuai OS kamu:

macOS / Linux:

mkdir -p ~/.config/gdrive-mcp
mv ~/Downloads/gcp-oauth.keys.json ~/Downloads/tokens.json ~/.config/gdrive-mcp/

Kalau download ZIP:

unzip ~/Downloads/gdrive-mcp-setup.zip -d ~/Downloads/gdrive-setup
mkdir -p ~/.config/gdrive-mcp
mv ~/Downloads/gdrive-setup/gcp-oauth.keys.json ~/Downloads/gdrive-setup/tokens.json ~/.config/gdrive-mcp/

Verifikasi:

ls -la ~/.config/gdrive-mcp/
# Harus ada gcp-oauth.keys.json dan tokens.json

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$env:APPDATA\gdrive-mcp" | Out-Null
Move-Item -Force "$env:USERPROFILE\Downloads\gcp-oauth.keys.json","$env:USERPROFILE\Downloads\tokens.json" "$env:APPDATA\gdrive-mcp\"

Verifikasi:

Get-ChildItem "$env:APPDATA\gdrive-mcp\"
# Harus ada gcp-oauth.keys.json dan tokens.json

3. Update claude_desktop_config.json

Buka Claude Desktop → Settings → Developers → Edit Config.

Di halaman setup, klik “Copy snippet” (pastikan tab OS sesuai). Snippet untuk macOS kira-kira seperti ini:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@piotr-agier/google-drive-mcp"],
      "env": {
        "GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/Users/<you>/.config/gdrive-mcp/gcp-oauth.keys.json",
        "GOOGLE_DRIVE_MCP_TOKEN_PATH": "/Users/<you>/.config/gdrive-mcp/tokens.json"
      }
    }
  }
}

Windows: command jadi npx.cmd, path jadi C:/Users/<you>/AppData/Roaming/gdrive-mcp/...

Ganti <you> dengan username kamu (cek dengan whoami di terminal). Contoh kalau username nurcholis:

"GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/Users/nurcholis/.config/gdrive-mcp/gcp-oauth.keys.json"

Kalau config sudah ada MCP server lain, jangan timpa seluruh file — gabungkan entry google-drive ke dalam mcpServers yang sudah ada:

{
  "mcpServers": {
    "slack": { "..." },
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@piotr-agier/google-drive-mcp"],
      "env": {
        "GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/Users/nurcholis/.config/gdrive-mcp/gcp-oauth.keys.json",
        "GOOGLE_DRIVE_MCP_TOKEN_PATH": "/Users/nurcholis/.config/gdrive-mcp/tokens.json"
      }
    }
  }
}

Perhatikan koma sebelum "google-drive" — JSON wajib pakai koma antar entry. Kalau lupa, Claude Desktop gagal load.

Save file (Cmd+S / Ctrl+S).

4. Restart Claude Desktop

Quit penuh — jangan hanya tutup window:

• macOS: Cmd+Q, atau menu Claude → Quit Claude Desktop
• Windows: system tray kanan bawah → ikon Claude → klik kanan → Quit
• Linux: system tray → ikon Claude → Quit. Atau pkill claude di terminal

Buka Claude Desktop lagi.

5. Aktifkan & Test

1. Buka tab Cowork di Claude Desktop
2. Cari connector bernama google-drive di list MCP servers
3. Pastikan statusnya enabled / connected (toggle hijau)
4. Test dengan prompt:

List 5 file terbaru di Google Drive saya

Kalau berhasil, Claude akan return list file kamu. 🎉

Setelah Setup

• Access token punya umur 1 jam. MCP otomatis refresh pakai refresh token — kamu tidak perlu setup ulang.
• Refresh token tidak expire untuk Workspace internal app. Setup ini valid selamanya atau sampai kamu revoke akses dari myaccount.google.com.
• File tokens.json di disk kamu akan diupdate otomatis setiap kali refresh — itu normal, biarkan saja.

Troubleshooting

Cara reset dari awal:

# macOS / Linux
rm -rf ~/.config/gdrive-mcp

# Windows
Remove-Item -Recurse -Force "$env:APPDATA\gdrive-mcp"

Hapus entry google-drive dari config, restart Claude, mulai dari Langkah 1.

Keamanan

• Server tidak menyimpan token kamu — hanya ada di sesi in-memory selama 10 menit, lalu dihapus.
• Token disimpan di disk lokal sebagai tokens.json dengan permission owner-only. Jangan share folder tersebut.
• Token memberikan akses penuh ke Drive, Docs, Sheets, Slides, dan Calendar — treat seperti password.
• Kalau resign atau pindah laptop: hapus folder gdrive-mcp dari laptop lama dan revoke akses dari myaccount.google.com.

Bantuan

Stuck? Hubungi nurcholis@qiscus.com dengan menyertakan:

• OS kamu (Windows / macOS / Linux + versi)
• Versi Claude Desktop (Settings → About)
• Pesan error persis (screenshot ok)
• Langkah yang sudah kamu coba