MagicMirror² v2.13.0 is available! For more information about this release, check out this topic.

MMM-Monzo - A high quality Monzo Module

  • Chat on Gitter dependencies Status Build Status Greenkeeper badge

    From the creator of MMM-Awesome-Alexa, I present:



    Monzo Module for Magic Mirror

    screen shot 2018-06-02 at 20 55 28


    Operating System Works? Notes
    Linux / Raspberry Pi ✔ -
    macOS ✔ -
    Windows ✔ -


    1. Clone this repo into the /modules folder as usual
    2. run $ npm install in /MMM-Monzo


    The final config should look something like this:

    		module: "MMM-Monzo",
    		position: "top_center",
    		config: {
    			clientId: "oauth2client_00009XfHYT...",
    			clientSecret: "mnzconf.++er4iwMs4CtoYUdpRjpIn+UL6/NwqA88E...",
    			accountId: "acc_00005Ufdh...",
    			refreshToken: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJl..."

    Getting the Client ID and Client Secret

    1. Go to
    2. Create a new Confidential Client
    3. Be sure to set the Redirect URL to: http://localhost:8080/oauth
    4. Your Client should look like:
    5. Keep note of the Client ID, Client Secret

    Getting the Account ID

    Normally everybody should have 1, but if you have multiple Monzo cards (like me), then you have multiple account IDs. MMM-Monzo only supports 1 account at a time.

    1. Go to
    2. Click on List accounts on the side
    3. Click on Send to fetch all accounts.
    4. Pick your account, most of the time there should only be one anyway. E.g. acc_00005UxdhBxP1wQytx9dOX

    Getting the Refresh token

    1. run $ npm run token-helper inside the /MMM-Monzo folder
    2. Follow the instructions

    Made with 💖 by Dolan

  • Very nice!

    I am a little too paranoid having all my payments on show though 😛

Log in to reply