Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
  Address Book Export

My fiancée and I were just under 100 days until our wedding and I was trying to export the addresses that we had previously saved to from our Save the Dates, but was dismayed to learn that there was no export feature! So I built a Python script to effectively export the saved address book.

Check out my blog post for more info.


Based on feedback (thanks, @dlithio), there are currently two different ways to implement this tool and export your address book from

  1. Fully-automated scripts to export data as csv and xlsx files using Python and Selenium Webdriver. See below for steps on how to run this script.
  2. A more manual approach to download the data as a json file, and optionally convert the json file to csv or xlsx formats. See below for steps on how to run this script.

Getting Started - Automated Method

  1. Assuming you have Python 3.6+ and a GitHub account, clone the repo:
git clone
  1. Navigate into the repository you just cloned:
cd minted-export
  1. Start a virtual environment:
python3 -m venv env
source env/bin/activate
pip install --upgrade pip # Optional but helpful
pip install -r requirements-dev.txt

You can deactivate the virtual environment with deactivate.

  1. Export your Minted address book:

Before getting the addresses, you'll need to have your Minted login credentials handy. It might be helpful to add them as environment variables called minted_email and minted_password, respectively. Or simply run the script and input them when prompted.

To run the script:


Running the above will scrape all of the events and output the address book fields as csv and xlsx file into the data/ dir of the project.

Getting Started - Manual Approach

If you are having issues setting up the Python environment or running the script, there's another more manual method that you can implement as well.

  1. Navigate to Minted in your browser and login. Once logged in, navigate to

  2. Save the page source to this directory on your computer. This should be a .json file containing all of your address book entries.

In order to convert this json file to a csv or xlsx file, you can either use a json-csv converter of your choice (e.g., or run the script included in this repo.

  1. Make sure you have your python environment setup (see Steps 1-3 above).

To run the script:


Running the above will convert the json file and save both csv and xlsx files into the data/ dir of the project.

See the example folder for example input/output of the script. 🎅

Need Assistance?

Are you running into an issue and don't know what to do next? Write a comment in the discussions page and I'll help you get it sorted.

Improvements & Suggestions

Experienced developer with comments or tweaks? Fork the repo and file a pull request with your changes.


A utility to export addresses from



Code of conduct





No releases published


No packages published