To configure Google Sheets with Mage, you’ll need to enable several APIs in your GCP project and add credentials to Mage.

Enable relevant APIs

Using Google Sheets in Mage requires the following to be enabled via GCP:

  • Google Drive API
  • Google Sheets API

Additionaly, the Google Sheet must be shared with the service account used in Mage.

You can follow this guide to enable relevant services.

Add credentials

Adding credentials for Sheets is the same as adding credentials for other Google services, i.e. BigQuery, GCP.

Before you begin, you’ll need to create a service account key. Please read Google Cloud’s documentation on how to create that.

Once your finished, following these steps:

  1. Create a new pipeline or open an existing pipeline.
  2. Expand the left side of your screen to view the file browser.
  3. Scroll down and click on a file named io_config.yaml.
  4. Enter the following keys and values under the key named default (you can have multiple profiles, add it under whichever is relevant to you)
  5. Note: you only need to add the keys under GOOGLE_SERVICE_ACC_KEY or the value for key GOOGLE_SERVICE_ACC_KEY_FILEPATH (both are not simultaneously required. If you use GOOGLE_SERVICE_ACC_KEY_FILEPATH, please delete GOOGLE_SERVICE_ACC_KEY in the io_config.yaml).
version: 0.1.1
    type: service_account
    project_id: project-id
    private_key_id: key-id
      "-----BEGIN PRIVATE KEY-----\nyour_private_key\n-----END_PRIVATE_KEY"
    client_email: your_service_account_email
    auth_uri: ""
    token_uri: ""
    auth_provider_x509_cert_url: ""
    client_x509_cert_url: ""
  GOOGLE_SERVICE_ACC_KEY_FILEPATH: "/path/to/your/service/account/key.json"


We have two templates for using Google Sheets with Mage. They can be found in Python “Data Loader” and “Data Exporter” templates.

You can see the source code for the templates here and here.