Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cesarferreira/monzo-cli
:credit_card: Monzo bank command line interface client
https://github.com/cesarferreira/monzo-cli
Last synced: 15 days ago
JSON representation
:credit_card: Monzo bank command line interface client
- Host: GitHub
- URL: https://github.com/cesarferreira/monzo-cli
- Owner: cesarferreira
- Created: 2016-11-25T17:25:17.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-06-17T23:13:34.000Z (over 2 years ago)
- Last Synced: 2024-11-12T22:35:54.703Z (30 days ago)
- Language: Ruby
- Homepage: https://monzo.com/
- Size: 202 KB
- Stars: 26
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-monzo - monzo-cli - Monzo bank command line interface client (Apps)
README
# monzo-cli
[](https://badge.fury.io/rb/monzo-cli)
[](https://travis-ci.org/cesarferreira/lasertag) [](https://hakiri.io/github/cesarferreira/lasertag/master)
[](https://codeclimate.com/github/cesarferreira/monzo-cli)
[](http://inch-ci.org/github/cesarferreira/monzo-cli)
> Finally a bank with an API
# Usage
## Balance
```bash
$ monzo-cli balance
+---------+-------------+
| Balance | Spent today |
+---------+-------------+
| £490 | £10 |
+---------+-------------+
```
## Transactions list
```bash
$ monzo-cli transactions
+----------+---------------------------+------------------------------------------+----------+
| Amount | date | Description | Balance |
+----------+---------------------------+------------------------------------------+----------+
| £ -5.59 | 2016-11-26T02:30:17+00:00 | Amazon EU AMAZON.CO.UK LUX | £ 37.42 |
+----------+---------------------------+------------------------------------------+----------+
| £ -46.99 | 2016-11-25T11:01:21+00:00 | Amazon Prime Now UK 811-111-1111 LUX | £ 43.01 |
+----------+---------------------------+------------------------------------------+----------+
| £ 1.00 | 2016-11-25T11:00:55+00:00 | Amazon Prime Now UK 811-111-1111 LUX | £ 90.00 |
+----------+---------------------------+------------------------------------------+----------+
| £ -1.00 | 2016-11-25T11:00:54+00:00 | Amazon Prime Now UK 811-111-1111 LUX | £ 89.00 |
+----------+---------------------------+------------------------------------------+----------+
| £ -10.00 | 2016-11-25T09:39:47+00:00 | SKY RESTAURANT STAFF TOP UP GBR | £ 90.00 |
+----------+---------------------------+------------------------------------------+----------+
| £ 0.00 | 2016-11-25T08:59:17+00:00 | Uber BV help.uber.com NLD | £ 100.00 |
+----------+---------------------------+------------------------------------------+----------+
| £ 100.00 | 2016-11-24T20:00:02+00:00 | Initial top up | £ 100.00 |
+----------+---------------------------+------------------------------------------+----------+
```
## Accounts
```bash
$ monzo-cli accounts
+---------------------+----------------------+
| Description | Date created |
+---------------------+----------------------+
| Peter Pans Account | 2015-11-13T12:17:42Z |
+---------------------+----------------------+
```
## Install
```bash
gem install monzo-cli
```
## Setup
Get your access tokens from this URL: https://developers.getmondo.co.uk/api/playground
Please create/edit it on `~/.monzo-cli.yml` with this format:
```yml
user_id: 18231092askdas9212
account_id: acc_0aksdaklsjSh28181
access_token: Qnjdas8hakxdjasQscGVgnVGIVXpvpZ5uCxkQ5XLnDHnOPoBtXreQ6adBo
```
## Caveats
- Right now the `access_token` expires everyday, still need to find a way to refresh it automatically
## Contributing
I welcome and encourage all pull requests. It usually will take me within 24-48 hours to respond to any issue or request. Here are some basic rules to follow to ensure timely addition of your request:
1. If its a feature, bugfix, or anything please only change code to what you specify.
2. Please keep PR titles easy to read and descriptive of changes, this will make them easier to merge :)
3. Pull requests _must_ be made against `develop` branch. Any other branch (unless specified by the maintainers) will get rejected.
4. Check for existing [issues](https://github.com/cesarferreira/monzo-cli/issues) first, before filing an issue.
5. Have fun!
### Created & Maintained By
[Cesar Ferreira](https://github.com/cesarferreira) ([@cesarmcferreira](https://www.twitter.com/cesarmcferreira))