If you want to keep an eye on your Vodafone Germany mobile phone contract and make your smart home smarter with Home Assistant at the same time, then you've come to the right place. In this article, I'll show you how the integration MyVodafone works and what you can do with it.
For detailed instructions and an explanation of all configuration options, I recommend the YouTube video linked below. In this video, every single setting is explained in detail so that you receive comprehensive instructions for the exact setup. You can find any code from the video in this article so that you can use it directly without having to type it in.
Make MyVodafone smart
The integration comes from stickpin's open source project on GitHub. It allows you to display your Vodafone contract components (minutes, SMS, data volume) as sensors in Home Assistant: how much you have used, how much is left, how many days are left until the next billing cycle, etc.
This gives you smart monitoring - no more tedious manual checking in the app. Here are the most important features:
- Minutes: used / remaining / total.
- SMS: used / remaining / total.
- Data volume: used / remaining / total.
- Support for multiple packages (e.g. main and additional contract) in a number setup.
- Billing summary (current/last) and days to end of cycle.
Why should you set this up?
- You get an immediate overview of your contract usage - no more guesswork.
- In the smart home, for example, you can automate warnings if your data volume falls below a threshold value.
- You can build visualizations (e.g. dashboard) or integrate them into automations ("If data consumption > 80 % then notification").
- It is open source - so no more proprietary app dependency, but rather integration into your individual smart home system.
Requirements & notes
- You need a functional Home Assistant installation
- Make sure that your Vodafone login is correct and that two-factor authentication is not activated.
- Data protection: Your contract data is in the home network - ensure password protection and secure Home Assistant installation.
- Error: In the community, users report that not all sensors always appear for prepaid contracts or additional contracts -> see Home Assistant Community
- Incompatibilities: If Vodafone makes changes to the API, the integration may temporarily not work - check the GitHub issue board.
What is Home Assistant?
Home Assistant is an open source platform for home automation that aims to connect and centrally control all devices in the home. It is designed to provide a unified user interface and simple, flexible control for a variety of smart home devices from different ecosystems. Here are some points in favor of Home Assistant:
- CompatibilityHome Assistant supports thousands of devices and services from various manufacturers, including lighting, air conditioning, heating, cameras, weather sensors, voice assistants and more.
- Local controlUnlike many commercial smart home platforms that rely on cloud services, Home Assistant runs locally on your network. This means increased privacy and reliability, as your smart home devices work even without an active internet connection.
- Automation and scenesOne of the main features of Home Assistant is the ability to create complex automations and scenarios. For example, you can have lights switch on automatically when it gets dark or turn on the heating when the temperature falls below a certain level.
- Simple user interfaceHome Assistant offers a user-friendly interface that makes it easy to monitor and control devices. This interface is fully customizable.
- Integration with voice assistantsHome Assistant can be integrated with voice assistants such as Amazon Alexa or Google Assistant to enable voice-controlled control of your smart home devices.
- Open source and community-drivenSince Home Assistant is open source, it is supported by an active community that is constantly developing new integrations and improving existing ones.
- Data protection and securityAs a locally running platform, Home Assistant has the advantage that the data remains within its own network. This protects privacy and increases security compared to cloud-based solutions.
In summary, Home Assistant is a powerful and flexible solution for those who want to design their own smart home and control their devices centrally, regardless of the manufacturer or ecosystem.
Installation of HACS and integration of MeinVodafone in Home Assistant
Step 1: Installing HACS in Home Assistant
Home Assistant Community Store (HACS) is a custom add-on for Home Assistant that provides access to a variety of custom integrations and plugins developed by the community. How to install HACS:
- Check requirements: Make sure that your Home Assistant is ideally up to date.
- Download Execute script: Open a terminal for the Docker container version or the core version.
- Docker: Dial into the container with:
docker exec -it homeassistant bashor (similar) - Core: Switch to the user who is running Home Assistant
- Execute the following command for both variants:
wget -O - https://get.hacs.xyz | bash -
- Docker: Dial into the container with:
- Restarting the Home Assistant: After the files have been copied, restart Home Assistant.
- Integrate HACS into Home AssistantGo to "Configuration" > "Integrations" > "Add" in the Home Assistant interface and search for HACS. Add it and enter your GitHub token if prompted.
For the supervised version, please refer to the Documentation of HACS itself to read about the installation.
Step 2: Add MyVodafone integration via HACS
Once HACS is installed, you can simply add MeinVodafone:
- Open HACS: Go to HACS in the Home Assistant interface.
- Search for integrationClick on "Integrations" and use the search function to search for "MeinVodafone".
- If not foundClick on the three dots at the top right and on "Custom repositories". Add the link to the GitHub repository of MeinVodafone (https://github.com/stickpin/homeassistant-meinvodafone) and select "Integration" as the type. You can then also find it in the search.
- Install MyVodafoneFind MyVodafone in the list and click on "Install". This will add the integration to your Home Assistant.
- Restarting the Home Assistant: Start Home Assistant again to apply the changes.
- Configure MyVodafoneAfter restarting, you can set up and customize MyVodafone via "Configuration" > "Integrations" in Home Assistant.
Conclusion
With these steps, you have successfully installed HACS in your Home Assistant and added the MyVodafone integration. This powerful combination opens up a world of additional features and customizations that have been and are being developed by the Home Assistant community. More blog posts and videos on useful integrations to follow. If you don't want to miss it, subscribe to my YouTube channel!
Use Vodafone integration
Sensors were created such as sensor.myvodafone_data_remaining, sensor.myvodafone_minutes_used etc. (as example names).
If no sensors appear, check the log file for error messages - your access data may be incorrect, or Vodafone may be blocking access.
Now you can, for example:
- Build a Lovelace dashboard with a "Contract status" card.
- Automation: When
sensor.myvodafone_data_remaininge.g. 500 MB → mobile app notification or a persistent Home Assistant notification. - Display history, recognize consumption trends.
Concrete example
Just imagine: You have a mobile contract with 10 GB data volume. You see this in Home Assistant:
sensor.myvodafone_data_total: 10.000 MBsensor.myvodafone_data_used: 8.200 MBsensor.myvodafone_data_remaining: 1.800 MBsensor.myvodafone_cycle_days_left: 6 days
You can create an automation:
trigger:
platform: numeric_state
entity_id: sensor.myvodafone_data_remaining
below: 1000
action:
service: notify.mobile_app_your_device
data:
message: "Data volume below 1 GB - check consumption!"💡 What's happening here?
- Trigger:
This automation starts when the sensorsensor.myvodafone_data_remaining(i.e. your remaining data volume) under 1000 MB falls.
→ You can of course adjust this value (e.g.below: 500for 500 MB). - Action:
As soon as the trigger becomes active, Home Assistant sends a push notification to your mobile device via thenotify.mobile_app_...service (e.g. your companion app).
→ The message then reads: "Data volume under 1 GB - check consumption!" - Target:
Warn you in good time before you exceed your data limit or incur throttling/additional costs.
For example, you are protected at an early stage before additional costs are incurred. Depending on your contract settings, of course.
Automation ideas
🧭 Check consumption in relation to the cycle
For example, if you still have many days left, but a lot of volume is already gone:
trigger:
- platform: template
value_template: >
{% set remaining = states('sensor.myvodafone_data_remaining') | float %}
{% set total = states('sensor.myvodafone_data_total') | float %}
{% set days_left = states('sensor.myvodafone_cycle_days_left') | int %}
{% set used_percent = (100 - (remaining / total * 100)) | round(1) %}
{{ used_percent > 80 and days_left > 7 }}
action:
- service: notify.mobile_app_your_device
data:
message: >
You have already used {{ used_percent }} %, but still have {{ days_left }} days left in the cycle! Stay frugal!Idea:
If you have used up more than 80 % of your data volume, but there are still more than 7 days until the reset, you will receive a warning.
📊 Trend notification (if consumption increases too quickly)
You can use a template condition to check whether the consumption per day is too high - e.g. more than 1 GB per day.
trigger:
- platform: time
at: "20:00:00" # check once a day
condition:
- condition: template
value_template: >
{% set used = states('sensor.myvodafone_data_used') | float %}
{% set total = states('sensor.myvodafone_data_total') | float %}
{% set days_passed = (30 - (states('sensor.myvodafone_cycle_days_left') | int)) %}
{{ days_passed > 0 and (used / days_passed) > (total / 30 * 1.2) }}
action:
- service: notify.mobile_app_your_device
data:
message: >
Your data consumption per day is above average! Current {{ (used / days_passed) | round(1) }} MB per day.Idea:
Home Assistant recognizes when you are using up your volume too quickly.
🧠 Combination with other devices or services
You can even combine the Vodafone data with other smart home data:
- If you high data consumption have and are currently on the road → Remember to activate WLAN.
- When
days_left < 3→ Reminder of contract or prepaid top-up. - When
sensor.myvodafone_data_remaining < 100→ Automatically deactivate the Wi-Fi hotspot.
YouTube video implementation
Conclusion
With the MeinVodafone integration for Home Assistant, you get a smart and transparent solution for tracking your Vodafone mobile contract in your smart home. Instead of regularly checking the Vodafone app, you have all the relevant data directly in your dashboard. You can also start automations - e.g. warnings when consumption is high. If you are already using Home Assistant, this is a real benefit.
Links at a glance
- GitHub repository: stickpin/homeassistant-myvodafone
0 Comments