Skip to content
No description or website provided.
Branch: master
Clone or download
Latest commit 827e74f Nov 4, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
myusps added support for firefox headless Apr 21, 2018
tests fix lint and test Feb 12, 2018
.gitignore initial code commit Jan 4, 2017
.travis.yml bump requests Nov 4, 2018
LICENSE Initial commit Jan 3, 2017
Makefile initial code commit Jan 4, 2017 Update Feb 14, 2018
pylintrc initial code commit Jan 4, 2017 bump requests Nov 4, 2018
tox.ini Update tox.ini Feb 14, 2018

Build Status PyPI version


Python 3 API for USPS Informed Delivery, a way to track packages and mail.



Sign up for Informed Delivery and verify your address.


Install Google Chrome and Chromedriver. These are dependencies for the Selenium webdriver, which is used internally to this module to facilitate the login process.

Instructions (adapt as necessary for your OS):

Note that installing Selenium Server is not required.


pip install myusps


import myusps

# Establish a session.
# Use the login credentials you use to login to My USPS via the web.
# A login failure raises a `USPSError`.
session = myusps.get_session("username", "password")

# Get your profile information as a dict. Includes name, address, phone, etc.
profile = myusps.get_profile(session)

# Get all packages that My UPS knows about.
packages = myusps.get_packages(session)

# Get mail delivered on a given day.
import datetime
mail = myusps.get_mail(session,


Session cookies are cached by default in ./usps_cookies.pickle and will be used if available instead of logging in. If the cookies expire, a new session will be established automatically.

HTTP requests are cached by default in ./usps_cache.sqlite. HTTP caching defaults to 5 minutes and can be turned off by passing cache=False to get_session. The cache expiry can be adjusted with the keyword argument cache_expiry.





make release


Contributions are welcome. Please submit a PR that passes tox.


Not affiliated with USPS. Does not use USPS Web Tools API. Use at your own risk.

You can’t perform that action at this time.