mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-12-10 13:05:27 -06:00
Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: ecspiegel <87676266+ecspiegel@users.noreply.github.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: alawadhi3000 <5523980+alawadhi3000@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Franck Nijhof <git@frenck.dev> Co-authored-by: Marcel van der Veldt <m.vanderveldt@outlook.com> Co-authored-by: staticdev <staticdev-support@proton.me> Co-authored-by: tronikos <tronikos@users.noreply.github.com> Co-authored-by: AlCalzone <dominic.griesel@nabucasa.com> Co-authored-by: Martin Hjelmare <marhje52@gmail.com> Co-authored-by: essys <essys@users.noreply.github.com> Co-authored-by: Abílio Costa <abmantis@users.noreply.github.com> Co-authored-by: Gord <31004434+googanhiem@users.noreply.github.com> Co-authored-by: Darren Griffin <darren.griffin@live.co.uk> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: hanwg <han.wuguang@gmail.com> Co-authored-by: Adam W <35391288+A-damW@users.noreply.github.com> Co-authored-by: Hessel <hesselonline@users.noreply.github.com> Co-authored-by: Damien Sorel <mistic@strangeplanet.fr> Co-authored-by: Tempura San <tempura.san@gmail.com> Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com> Co-authored-by: J. Diego Rodríguez Royo <jdrr1998@hotmail.com> Co-authored-by: lexitus <38081592+lexitus@users.noreply.github.com> Co-authored-by: Sid <27780930+autinerd@users.noreply.github.com> Co-authored-by: Evgeny Sureev <u@litka.ru> Co-authored-by: Stefan Agner <stefan@agner.ch> Co-authored-by: TomArm <TomArm@users.noreply.github.com> Co-authored-by: starkillerOG <starkiller.og@gmail.com> Co-authored-by: Maciej Bieniek <bieniu@users.noreply.github.com> Co-authored-by: Guillaume Rischard <github@stereo.lu> Co-authored-by: Geoff <85890024+Thulrus@users.noreply.github.com> Co-authored-by: GhoweVege <85890024+GhoweVege@users.noreply.github.com> Co-authored-by: Logan Rosen <loganrosen@gmail.com> Co-authored-by: Robert Resch <robert@resch.dev> Co-authored-by: RanTheLab <RanTheLab@users.noreply.github.com> Co-authored-by: Jan Bouwhuis <jbouwh@users.noreply.github.com> Co-authored-by: John Hess <john@h3ss.com> Co-authored-by: Marco <cdrfun@cdrfun.eu> Co-authored-by: robthebold <38596885+robthebold@users.noreply.github.com> Co-authored-by: Paulus Schoutsen <balloob@gmail.com> Co-authored-by: Pieter Rautenbach <parautenbach@gmail.com> Co-authored-by: Tsvi Mostovicz <ttmost@gmail.com> Co-authored-by: Michael <35783820+mib1185@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> Co-authored-by: Galorhallen <12990764+Galorhallen@users.noreply.github.com> Co-authored-by: Jan-Philipp Benecke <jan-philipp@bnck.me> Co-authored-by: Jan Čermák <sairon@users.noreply.github.com> Co-authored-by: Norbert Rittel <norbert@rittel.de> Co-authored-by: Mr. Snyds <41122989+mrsnyds@users.noreply.github.com> Co-authored-by: Allen Porter <allen.porter@gmail.com> Co-authored-by: Ludovic BOUÉ <lboue@users.noreply.github.com> Co-authored-by: threatdisplay <ajbriones@gmail.com> Co-authored-by: Kamil Breguła <mik-laj@users.noreply.github.com> Co-authored-by: Simone Chemelli <simone.chemelli@gmail.com> Co-authored-by: Timothy <6560631+TimoPtr@users.noreply.github.com> Co-authored-by: Joris Pelgröm <jpelgrom@users.noreply.github.com> Co-authored-by: Wendelin <12148533+wendevlin@users.noreply.github.com> Co-authored-by: Arie Catsman <120491684+catsmanac@users.noreply.github.com> Co-authored-by: Marko Dimjašević <marko@dimjasevic.net> Co-authored-by: karwosts <32912880+karwosts@users.noreply.github.com> Co-authored-by: Guido Schmitz <Shutgun@users.noreply.github.com>
58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
---
|
|
title: Monzo
|
|
description: Instructions on how to integrate Monzo integration into Home Assistant.
|
|
ha_category:
|
|
- Finance
|
|
- Sensor
|
|
ha_release: 2024.6
|
|
ha_iot_class: Cloud Polling
|
|
ha_codeowners:
|
|
- '@jakemartin-icl'
|
|
ha_config_flow: true
|
|
ha_domain: monzo
|
|
ha_platforms:
|
|
- sensor
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
The **Monzo** {% term integration %} allows you to connect your Monzo bank accounts to Home Assistant.
|
|
|
|
|
|
## Prerequisites and approval
|
|
|
|
1. Before adding the Monzo integration, you'll need to create a [Monzo developer account](https://developers.monzo.com/).
|
|
2. From here, you need to create a new OAuth client for Home Assistant to use by going to **Clients** > **New OAuth Client**.
|
|
3. Then, fill in the form as follows, making sure to **copy the URL shown** - don't replace it with your own URL:
|
|
- Name: Home Assistant
|
|
- Logo URL: This can be left blank
|
|
- Redirect URLs: <https://my.home-assistant.io/redirect/oauth>
|
|
- Description: For example: Used by the Monzo Home Assistant Integration
|
|
- Confidentiality: Confidential
|
|
|
|
4. Once submitted, you can proceed with adding the integration.
|
|
- Go to {% my integrations title="**Settings** > **Devices & services**" %}, and add the **Monzo** integration.
|
|
- Fill in the OAuth details for the client you've created in the Monzo developer portal.
|
|
- **Important** - After authorizing Home Assistant access via email, for security you'll also need to verify again from within the Monzo app.
|
|
- A reminder to do this will be displayed in Home Assistant before completing the installation - don't proceed until you've done this from the popup in the mobile app.
|
|
- If you've forgotten to do this, the integration will fail to load, but you can simply accept the popup and reload the integration without entering your details again.
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
### Adding a second account
|
|
|
|
1. To add a second Monzo account in Home Assistant, repeat the above process for creating an OAuth client.
|
|
2. Then, in Home Assistant, add the new credentials *before* trying to add the new entry.
|
|
- In the top right of **Devices & services** page, select the three dots {% icon "mdi:dots-vertical" %} menu, open **Application Credentials**, and select **Add application credentials**
|
|
- It is recommended to include the person's name in the *Name* field so you can distinguish it later.
|
|
3. Once added, you can return to **Devices & services** > **Monzo** > **Add Entry** to proceed with authentication.
|
|
|
|
## Sensor
|
|
|
|
The integration will create a device for each of your accounts and pots. For an account or a pot, you'll have:
|
|
|
|
- Balance: The current balance of the account.
|
|
|
|
Additionally, an account will also have:
|
|
|
|
- Total Balance: The current balance of that account plus all of its pots.
|