So you wanna pull some google sheets data into python?

gspread is a really handy python module for doing just that. There’s some authentication setup involved but it’s pretty straightforward.

Once you’ve authenticated, you can check out the readme for basic usage for reading/writing to and from sheets over at



You need to set up your credentials so you can access your google sheet. Fortunately this is pretty straightforward.

And the gspread documentation also has these instructions documented here.

I followed the instructions here but the tl;dr is that you need to head over to the API Console Credentials section of the google developers portal.

  1. Select ‘create a project’. Give it a name. Yatta yatta yatta.
  2. Select ‘create credentials’ > ‘Service Account Key’. I think this is the easiest. It’ll basically give you a file to download.
  3. Select ‘new service account’ and give it the ‘Owner’ role, along with some name.
  4. Select json key type.
  5. Hit ‘create’. This should download a .json file to your computer.
  6. Move that credentials file somewhere (let’s say ~/Desktop).

share a sheet

You’ll need to share your sheet with the service account you just created. From the credentials page, you should see a link for ‘Manage Service Accounts’. Check that out and you should see your service account ID for the one you just created. It’ll look something like

Share your sheet with that account. Boom.


install stuff

pip install gspread oauth2client PyOpenSSL

pull sheet

Now pull it! gspread has great documentation for using the module but I’ve found setup to be a big pain in the ass, so I hope this post helps.

import gspread
from oauth2client.service_account import ServiceAccountCredentials

# that filename path is the creds file you downloaded
credentials = ServiceAccountCredentials.from_json_keyfile_name(

gc = gspread.authorize(credentials)

worksheet ='My Workbook Title').worksheet('some sheet title')

records = worksheet.get_all_records()