pyfordpass
FordPass client and CLI. A third-party reverse-engineered client for the same private mobile-app endpoints the FordPass™ app uses, packaged as a Python library plus a fordpass command-line tool.
Disclaimer
This project is not an official Ford product. It is not affiliated with, endorsed by, sponsored by, or otherwise connected to Ford Motor Company or any of its subsidiaries. "FordPass", "The Lincoln Way", "Ford", and "Lincoln" are trademarks of Ford Motor Company.
Because this client speaks to private endpoints rather than a documented public API, Ford may change, throttle, or revoke access without notice - and the maintainer cannot guarantee that any particular feature will keep working.
Use of this software may cause your FordPass™ / The Lincoln Way™ account to be (temporarily) locked or suspended. Traffic from any unofficial client can look anomalous to Ford's fraud and abuse detection. Use at your own risk.
It is strongly recommended to use a separate, secondary FordPass™ account for this software rather than your primary account:
- In the FordPass app on a phone (signed in as the primary owner), invite a secondary email
address as an additional driver for the vehicle. The invited address must be reachable from that phone for verification.
- Sign up for a new FordPass account using that secondary email and accept the driver
invitation.
- Configure pyfordpass (fordpass auth login) with the secondary account's credentials.
If the secondary account is later suspended, your primary account, warranty records, and roadside-assistance enrolment remain unaffected.
See the ha-fordpass project's general disclaimer and account-setup guidance for the same procedure written up from the Home Assistant integration's perspective - the steps are identical regardless of which third-party client consumes the credentials.
Installation
pip install pyfordpassUsage
Add -d to show debug logs. Run with no arguments to see the top-level command list: