Mint Mobile - Home Assistant Integration

This integration creates sensors for each line and displays the remaining and used data usage for the month. If you have a Mint Mobile family, it will also pull in the data usage for each line. The sensor name includes additional attributes about the line.

WARNING: Running Multiple Clients (Token Invalidation)

Mint Mobile's API rotates refresh tokens and only allows one active session per account. Running another automated client (like the TypeScript MQTT bridge) or logging into the official mobile app will invalidate the integration's token.

When this happens, Home Assistant logs a 401 Unauthorized warning and automatically recovers via a full login. To avoid warnings, do not run other automated API clients.

Attributes Included:

• Number of months purchased for plan
• Days remaining in month (The number of days left in the data plan month)
• Days remaining for plan (The number of days left that you have purchased)
• Phone number
• Line name
• Last updated

Polling Interval

During setup you can specify how often the integration checks Mint Mobile for new data. The value is in hours and defaults to 12. Values less than 1 hour are not allowed.

Attributes As Additional Sensors

If you want to have the following attributes as additional sensors, during the setup process or under the integration options menu check 'Display Attributes As Additional Sensors'.

• Number of months purchased for plan
• Days remaining in month (The number of days left in the data plan month)
• Days remaining for plan (The number of days left that you have purchased)

---

Enjoying my integration? Help me out and buy me a ☕ for $3!

---

Installation

HACS (Recommended)

1. Have HACS installed, this will allow you to easily update
2. Add https://github.com/ryanmac8/HA-Mint-Mobile as a custom repository and Type: Integration
3. Click install under "Mint Mobile", restart your instance.

Manual Installation

1. Download this repository as a ZIP (green button, top right) and unzip the archive
2. Copy the mintmobile folder inside the custom_components folder to the Home Assistant /<config path>/custom_components/ directory
   • You may need to create the custom_components in your Home Assistant installation folder if it does not exist
   • On Home Assistant (formerly Hass.io) and Home Assistant Container the final location should be /config/custom_components/mintmobile
   • On Home Assistant Supervised, Home Assistant Core, and Hassbian the final location should be /home/homeassistant/.homeassistant/custom_components/mintmobile
3. Restart your instance.