{"id":23291880,"url":"https://github.com/jeeftor/mint-scraper-for-homeassistant","last_synced_at":"2025-07-01T00:04:21.099Z","repository":{"id":186084822,"uuid":"627074407","full_name":"jeeftor/mint-scraper-for-homeassistant","owner":"jeeftor","description":"AppDaemon script for scraping financial data from MINT to display in home assistant","archived":false,"fork":false,"pushed_at":"2023-10-25T12:47:36.000Z","size":892,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T18:21:18.739Z","etag":null,"topics":["appdaemon","appdaemon-apps","hacs","hacs-integration","home-assistant","mint"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeeftor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-12T18:22:15.000Z","updated_at":"2023-11-12T23:10:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"94d89e72-3f26-4bc5-b16d-f2dd466ee5d5","html_url":"https://github.com/jeeftor/mint-scraper-for-homeassistant","commit_stats":null,"previous_names":["jeeftor/mint-scraper-for-homeassistant"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/jeeftor/mint-scraper-for-homeassistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fmint-scraper-for-homeassistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fmint-scraper-for-homeassistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fmint-scraper-for-homeassistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fmint-scraper-for-homeassistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeeftor","download_url":"https://codeload.github.com/jeeftor/mint-scraper-for-homeassistant/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fmint-scraper-for-homeassistant/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262870851,"owners_count":23377309,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appdaemon","appdaemon-apps","hacs","hacs-integration","home-assistant","mint"],"created_at":"2024-12-20T05:28:05.796Z","updated_at":"2025-07-01T00:04:21.045Z","avatar_url":"https://github.com/jeeftor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mint Financial Data Scraper for Home Assistant (AppDaemon)\n\n![](docs/allyourmintarebelongtous.png)\n\nThis is an [AppDaemon Addon](https://github.com/hassio-addons/addon-appdaemon) for HomeAssistant that will log into a Mint account and scrape bank account data to be sent via MQTT into Home Assistant. It takes advantage of the [`mintapi`](https://github.com/mintapi/mintapi) python project to scrape data and then parses and sends the data over MQTT. Utilizing [MQTT Discovery](https://www.home-assistant.io/integrations/mqtt/#discovery-options) various entities for account balances will be created in HomeAssistant.\n\n![](docs/image.jpg)\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/hacs/integration)\n[![github-check-status](https://img.shields.io/github/checks-status/jeeftor/mint-scraper-for-homeassistant/master)](https://github.com/jeeftor/mint-scraper-for-homeassistant/actions?query=branch%3Amaster)\n[![last-release](https://img.shields.io/github/v/release/jeeftor/mint-scraper-for-homeassistant.svg)](https://github.com/jeeftor/mint-scraper-for-homeassistant/releases)\n[![downloads-latest](https://img.shields.io/github/downloads/jeeftor/mint-scraper-for-homeassistant/latest/total)](http://github.com/jeeftor/mint-scraper-for-homeassistant/releases/latest)\n\n## Configuration \u0026 Requirements\n\nAs this is an AppDaemon integration installation is a bit more complex than other integrations and you will need to make a variety of mods to your configuration files. I suggest you install the [**Studio Code Server**](https://github.com/hassio-addons/addon-vscode/blob/main/README.md) addon to assist in the process.\n\n### 1) - Modify AppDaemon Packages\n\nYou will need to ensure both the backing library and a chromium are installed in AppDaemon. You can do this via YAML like:\n\n```yaml\nsystem_packages:\n  - chromium-chromedriver\n  - chromium\npython_packages:\n  - mintapi\n```\n\nor like\n\n![](docs/AppDaemonOptions.yaml.png)\n\nor visually like:\n\n![](docs/AppDaemonOptions.png)\n\nOnce you hit save AppDaemon will then install the correct packages.\n\n### Modify various files\n\nAssuming you'v installed the **Studio Code Server** plugin and you can access it from the tool bar click:\n\n![](docs/StudioCode.png)\n\nto open **Studio Code**.\n\n### Ensure AppDaemon MQTT Plugin\n\nOpen the `appdaemon.yaml` file:\n\n![](docs/appdaemon.yaml.png)\n\nand ensure the **MQTT** plugin is enabled. Your configuration may look something like this:\n\n```yaml\n---\nsecrets: /config/secrets.yaml\nappdaemon:\n  latitude: 52.379189\n  longitude: 4.899431\n  elevation: 2\n  time_zone: Europe/Amsterdam\n  plugins:\n    HASS:\n      type: hass\n    MQTT:\n      type: mqtt\n      verbose: True\n      client_host: \u003cMQTT_SERVER_IP\u003e\n      client_port: 1883\n      client_id: appdaemon_client\n      client_user: appdaemon\n      client_password: appdaemon\nhttp:\n  url: http://127.0.0.1:5050\nadmin:\napi:\nhadashboard:\n```\n\n_Please refer to [AppDaemon documentation](https://appdaemon.readthedocs.io/en/latest/CONFIGURE.html) for help_\n\n### Store MINT Secrets\n\nOpen the `secrets.yaml` file and add the following information:\n\n```yaml\nmint_mfa_token: \u003cSEED_FOR_MFA_TOKEN\u003e\nmint_password: \u003cPASSWORD_FOR_MINT\u003e\nmint_email: \u003cEMAIL_FOR_MINT\u003e\n```\n\n_Refer to the [mintapi backing library](https://github.com/mintapi/mintapi#option-1-totp) for how to configure your `mint_mfa_token`_\n\n### Lastly its time to create an App Description\n\nOpen the `apps.yaml` file:\n\n![](docs/apps.yaml.png)\n\nand add the following application description:\n\n```yaml\nmint-scraper-for-home-assistant:\n  module: mint_scraper\n  class: MintScrapperApp\n  mint_mfa_token: !secret mint_mfa_token\n  mint_password: !secret mint_password\n  mint_email: !secret mint_email\n```\n\n| key              | optional | type   | description                                    |\n| ---------------- | -------- | ------ | ---------------------------------------------- |\n| `module`         | False    | string | The module name of the app.                    |\n| `class`          | False    | string | The name of the Class.                         |\n| `mint_email`     | False    | string | Email address registered with mint.            |\n| `mint_password`  | False    | string | The associated password.                       |\n| `mint_mfa_token` | False    | string | Seed to generate Time based One-Time password. |\n\n## Verifying Installation\n\nNext you can verify the installation one of two ways:\n\n1. Navigate to the AppDaemon admin interface on: http://\u003cHomeAssistant-URL/IP\u003e:5050\n2. Open the AppDaemon Addon and view the log files\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fmint-scraper-for-homeassistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeeftor%2Fmint-scraper-for-homeassistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fmint-scraper-for-homeassistant/lists"}