A spring break project to get my bank transaction data in Google Sheets without using Google Apps Script.
gsheets-plaid is a tool for getting your raw bank transaction data into a Google Sheets spreadsheet, to enable you to make your own formulas and charts for tracking spending, making goals, etc. This app is 100% free (assuming you don't already have a bunch of Google Cloud projects), but there is a bit of one-time setting up to do to get your Google and Plaid credentials in place. This README contains all the instructions to get you from a fresh install of the package to bank transactions in a Google Sheets file.
Please open an issue if something isn't working or if the documentation isn't clear.
- Python 3.10 or later
Using a virtualenv is a good idea.
python3 -m pip install gsheets-plaidFollow this tutorial
Be sure to enable the "Google Sheets API"
Follow this tutorial for creating OAuth client ID credentials for your Google account.
- Choose "Desktop app" in the tutorial
Before Google Cloud Platform will let you create OAuth client ID credentials, it will make you complete the OAuth consent screen. Fill out the required fields with your personal email, and choose an arbitrary application name. Since we aren't planning on publishing this app, it doesn't really matter.
On the "Scopes" step, add the following scope: https://www.googleapis.com/auth/drive.file. You can use the search feature and look up drive.file to quickly find the right scope.
On the "Test users" page, add the google account email that corresponds with the account you want to have the finance tracker saved on.
Here is a summary of how to create the credentials:
- Click "Create credentials"
- Click "OAuth client ID"
- Select "Desktop app"
- Type a name of your choice
- Click the download icon (when you hover it says "Download OAuth Client")
- Click "Download JSON"
Create a Plaid developer account here.
After you have created an account, go to Team Settings > Keys. You should see your client_id, as well as Development and Sandbox secrets.
To configure gsheets_plaid with all of these credentials we just created, run the following command:
python3 -m gsheets_plaid initYou will be given the opportunity to enter all the credentials necessary for syncing with Plaid and Google Sheets.
Note that you only need to supply the Plaid secret corresponding to the Plaid environment that gsheets_plaid runs in. In other words, you can just submit the Plaid sandbox secret and leave the development and production ones blank to start out. You can always come back and rerun init to update the config.
When it asks for the Google credentials JSON file, supply the absolute filepath to the JSON file we downloaded previously. Once you see that it is successfully saved, you can safely delete the copy of the credentials file from your downloads folder (or wherever you saved it).
We are finally getting to the exciting part!
If everything is configured correctly, running the following command will open a new browser tab with a small local web server you can use to connect a bank account.
python3 -m gsheets_plaid linkIf you are using the sandbox environment, note that the credentials are provided at the bottom of the screen. If you are using the development environment, use your actual bank account credentials. Note that you are only given 5 tokens to use in the development environment, but if you submit a ticket on Plaid Dashboard, you can get it bumped up to 100 tokens, which should be more than plenty for personal usage.
Once you have added all the bank accounts you want, close the browser tab and enter CTRL+C in the terminal you started the link command in to kill the web server process.
To sync your transactions from the banks you signed in with, run this command in the terminal
python3 -m gsheets_plaid syncIf this is the first time you're running the command, you'll see a new browser tab open and be asked to give this developer application permission to use Google Sheets. You should only have to do this once. A new finance tracker spreadsheet will be created and the transaction data will be synced to Sheet1. Subsequent runs of this command will reuse the same spreadsheet.
That's it! Hopefully you're inspired to write some cool formulas and make neat charts using this raw transaction data.
(for maintainers)
- Tag the main branch
git tag v[insert-version-here]
- Push latest commits with tags
git push origin --tags
- Build repo
python -m build
- Upload distribution archives to PyPi
python -m twine upload dist/*
- Create new release on GitHub