Registry / llm-agents / llama-index-readers-google

llama-index-readers-google

library0.7.2pypypi✓ verified 86d ago

A collection of Google data connector readers for LlamaIndex, supporting Google Drive, Gmail, Google Calendar, Google Sheets, and Google Docs. Currently at version 0.7.2, with frequent updates following the LlamaIndex release cadence.

llm-agents gcp data

pip install llama-index-readers-google

package ↗homepage ↗

INSTALL

IMPORT

SIG · LLAMA-INDEX-READER

llama-index-readers-google

llm-agentspythonv0.7.2

Install

26.6s avg

Import

7321ms

Disk

468MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 30.8s

py 3.11

✓ —

✓ 26.8s

py 3.12

✓ —

✓ 24.4s

py 3.13

✓ —

✓ 24.6s

py 3.9

✕ build_error

468MB installed

● package 468MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GoogleDriveReader

✓ from llama_index.readers.google import GoogleDriveReader

✗ from llama_index.readers.google_drive import GoogleDriveReader

Old import path was nested under google_drive, now consolidated under google

GmailReader

✓ from llama_index.readers.google import GmailReader

GoogleCalendarReader

✓ from llama_index.readers.google import GoogleCalendarReader

GoogleSheetsReader

✓ from llama_index.readers.google import GoogleSheetsReader

Initialize GoogleDriveReader with folder ID and optional service account key. Falls back to OAuth flow if no key provided.

import os from llama_index.readers.google import GoogleDriveReader # Set your Google OAuth credentials path or rely on default discovery reader = GoogleDriveReader( folder_id="<your-folder-id>", service_account_key_path=os.environ.get("GOOGLE_SERVICE_ACCOUNT_KEY", ""), ) documents = reader.load_data()

Debug

Known issues

breakingIn v0.5.0, the import paths were restructured. Previously readers were under 'llama_index.readers.google_drive', 'llama_index.readers.gmail', etc. Now all Google readers are under 'llama_index.readers.google'. Update imports accordingly.

fix

Change imports to 'from llama_index.readers.google import ...'

affects: <0.5.0

deprecatedThe 'service_account_key_path' parameter in GoogleDriveReader is deprecated in favor of 'credentials'.

fix

Use 'credentials' parameter with a GoogleOAuth2Credentials object instead.

affects: >=0.6.0

gotchaFolder ID for GoogleDriveReader is case-sensitive and must be the folder's ID (not name). Extracting from URL can be error-prone.

fix

Use the folder ID from the URL: 'https://drive.google.com/drive/folders/<folder-id>'

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'llama_index.readers.google_drive'

Import path changed in v0.5.0. Old code uses deprecated path.

fix

Update import to 'from llama_index.readers.google import GoogleDriveReader'

google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials.

Missing or invalid Google credentials. Either OAuth token or service account key not provided.

fix

Set GOOGLE_APPLICATION_CREDENTIALS environment variable to point to a JSON service account key, or run the OAuth flow.

AttributeError: 'GoogleDriveReader' object has no attribute 'load_data'

Likely using a very old version (<0.4.0) where the method was named 'load_documents'.

fix

Upgrade to latest: pip install --upgrade llama-index-readers-google

Upgrade

Version history

0.7.2latest on PyPI · released Sep 8, 2025

Audit

Dependencies

google-api-python-clientrequiredRequired for Google API authentication and service construction

google-auth-httplib2requiredTransitive dependency for OAuth2

google-auth-oauthlibrequiredUsed for OAuth2 flow

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/llama-index-readers-google/ ↗

homepagehttps://llamahub.ai ↗