Skip to content

monz

Package Version Supported Python Versions Read the Docs Codecov License Code style: black py.typed

Simple CLI for quickly accessing your Monzo account.

  • Works on Python 3.9+
  • Sensible defaults (don't specify account / pot ID if you only have one active)
  • Easy authentication (with automatic access token refreshing)
  • Pretty printing (via Rich)
  • Built on top of pawelad/pymonzo

This project is not officially affiliated with Monzo.

Installation

Since monz is a command line tool, the recommended installation method is via pipx:

$ pipx install monz

Of course, you can just install it directly from PyPI (ideally, inside a virtualenv):

$ python -m pip install monz

Quick start

Authentication

Before you can access your Monzo account details through monz, you need to authenticate it. You can do that with a (temporary) access token (for example, from the Monzo Developer Portal), or go through a one time OAuth setup that will save the token on disk and automatically refresh it when it expires.

To do the latter, you should first create an OAuth client in Monzo developer tools (with the "Redirect URL" set to http://localhost:6600/monz) and run the monz authorize command with the obtained client ID and client secret.

For more information, please take a look at: https://monz.pawelad.dev/en/latest/getting_started/#authentication

Usage

The default subcommand is info, which shows your account balance and its latest transaction:

$ monz
Balance:                 £203.78
Total balance:           £303.78
Currency:                GBP
Spend today:             £4.20
Local currency:          THB
Local exchange rate:     45.558219

Last transaction:
         -£17.29 | MomCorp
ID:              tx_0000Lxo9IgPERj43i03iKH
Description:     MomCorp
Amount:          -£17.29
Currency:        GBP
Category:        general
Notes:           ✨                       
Created:         Feb 12, 3024, 12:39:22 PM
Settled:         Feb 13, 3024, 1:36:48 AM

You can view all linked accounts:

$ monz accounts
   Account 'acc_87539319' (GB)   
ID:                 acc_87539319
Description:        user_1729
Currency:           GBP
Account Number:     0101100101   
Sort Code:          04-00-04                   
Type:               uk_retail                  
Closed:             No                         
Created:            Dec 31, 2999, 11:59:59 PM  

If you have only one (active) account, it will be used everywhere by default. If you have more, you'll have to pass its ID explicitly when needed via the --account_id option.

Finally, you can see your latest transactions:

$ monz transactions -n 2 
         -£17.29 | MomCorp
ID:              tx_0000Lxo9IgPERj43i03iKH
Description:     MomCorp
Amount:          -£17.29
Currency:        GBP
Category:        general
Notes:           ✨                       
Created:         Feb 12, 3024, 12:39:22 PM
Settled:         Feb 13, 3024, 1:36:48 AM

   -£100.00 | pot_0000aDhHH8z3jvram0L0Di   
ID:              tx_0000FskkLc0KB7aK0SV4cd
Description:     pot_0000aDhHH8z3jvram0L0Di
Amount:          -£100.00
Currency:        GBP
Category:        savings
Created:         Feb 6, 3024, 10:49:22 AM
Settled:         Feb 6, 3024, 10:49:22 AM

You can see all available subcommands and options by running monz --help (or adding --help to any subcommand).

Authors

Developed and maintained by Paweł Adamczak.

Source code is available at GitHub.

If you'd like to contribute, please take a look at the contributing guide.

Released under Mozilla Public License 2.0.