https://github.com/scottrobertson/monzo-export

https://github.com/scottrobertson/monzo-export

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/scottrobertson/monzo-export
• Owner: scottrobertson
• Created: 2016-10-24T18:55:28.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2021-01-08T22:49:47.000Z (almost 4 years ago)
• Last Synced: 2024-10-12T02:29:25.240Z (2 months ago)
• Language: Ruby
• Size: 34.2 KB
• Stars: 13
• Watchers: 2
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-monzo - Monzo to QIF CLI - Export Monzo transaction to QIF via CLI (Apps)

README

        
# Monzo Export

Export Monzo Transactions to QIF and CSV files.

### Install

```

git clone [email protected]:scottrobertson/monzo-export.git

bundle

```

### Quick Start

```

MONZO=token from https://developers.monzo.com/

ruby monzo-export.rb csv --access_token=$MONZO --since=2016-10-10 --folder=/path/to/folder

ruby monzo-export.rb qif --access_token=$MONZO --since=2016-10-10 --folder=/path/to/folder

```

#### Quick Start Current Account

```

MONZO=token from https://developers.monzo.com/

ruby monzo-export.rb qif --access_token=$MONZO --since=2016-10-10 --folder=/path/to/folder --current_account

```

### OAuth Configuration

This allows you to use a token from a client you set up on `https://developers.monzo.com/` and then omit the `--access_token` argument.

Create a new client (either confidential or non-confidential) with a redirect url of `http://localhost/monzo-export` and then make a note of the `clientID` and `clientSecret`.

To configure Monzo To QIF to use OAuth, first run

```

ruby monzo-export.rb auth --clientid {clientID} --clientsecret {clientSecret}

```

This will prompt you to browse to the Monzo auth url in your browser to obtain your authorization code. Completing this workflow will result in Monzo sending you an email with a login link. You need to copy this link and use it in the next command.

```

ruby monzo-export.rb authurl --url {link-from-email}

```

This completes the setup, retrieves and stores the access token.

#### Differences between Confidential and Non-confidential clients

- A confidential client will also give you a refresh token which is automatically used when your access token expires without any further input.

- A non-confidential client will prompt the user to re-authenticate whenever the access token expires.

The tokens are stored locally in `config.yml` so anyone with access to this folder also has access to your access/refresh tokens.