mmoney 0.1.0__tar.gz

mmoney-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alec Fong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mmoney-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: mmoney
+Version: 0.1.0
+Summary: CLI for Monarch Money - access your financial data from the command line
+Author-email: Alec Fong <alecfong1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theFong/mmoney-cli
+Project-URL: Repository, https://github.com/theFong/mmoney-cli
+Project-URL: Issues, https://github.com/theFong/mmoney-cli/issues
+Keywords: monarch money,cli,finance,personal finance,budgeting
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: monarchmoneycommunity>=1.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: keyring>=24.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: vulture>=2.13; extra == "dev"
+Requires-Dist: pre-commit>=4.0.0; extra == "dev"
+Requires-Dist: detect-secrets>=1.5.0; extra == "dev"
+Dynamic: license-file
+
+# mmoney-cli
+
+![CI](https://github.com/theFong/mmoney-cli/actions/workflows/ci.yml/badge.svg)
+
+> **Disclaimer:** This is an unofficial, community-built CLI tool. It is not affiliated with, endorsed by, or supported by Monarch Money. Use at your own risk.
+
+CLI for [Monarch Money](https://www.monarchmoney.com) - access your financial data from the command line.
+
+Built on top of [monarchmoneycommunity](https://github.com/bradleyseanf/monarchmoneycommunity).
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv tool install mmoney-cli
+
+# Or using pip
+pip install mmoney-cli
+```
+
+## Development
+
+```bash
+# Clone and install with uv
+git clone https://github.com/theFong/mmoney-cli.git
+cd mmoney-cli
+uv sync
+
+# Run CLI
+uv run mmoney --help
+```
+
+## Quick Start
+
+```bash
+# Best: Email + Password + MFA Secret (longest lasting, fully automated)
+# Enable MFA in Monarch settings, copy the secret key when setting up authenticator
+mmoney auth login -e your@email.com -p yourpassword --mfa-secret YOUR_SECRET --no-interactive
+
+# Good: Email + Password + MFA Code (requires manual code entry)
+mmoney auth login -e your@email.com -p yourpassword --mfa-code 123456
+
+# Alternative: Email + Password + Device UUID (requires browser)
+# 1. Open app.monarch.com, login, open DevTools Console
+# 2. Run: copy(localStorage.getItem('monarchDeviceUUID'))
+mmoney auth login -e your@email.com -p yourpassword --device-uuid YOUR_UUID --no-interactive
+
+# Fallback: Token from browser (shortest lived)
+# 1. Open app.monarch.com, login, open DevTools Network tab
+# 2. Click any 'graphql' request, find 'Authorization: Token YOUR_TOKEN' in Headers
+mmoney auth login --token YOUR_TOKEN
+```
+
+## Commands
+
+### Authentication
+```bash
+mmoney auth login      # Login to Monarch Money
+mmoney auth logout     # Delete saved session
+mmoney auth status     # Check authentication status
+```
+
+### Accounts
+```bash
+mmoney accounts list              # List all accounts
+mmoney accounts types             # List account types
+mmoney accounts create            # Create manual account
+mmoney accounts update <id>       # Update account
+mmoney accounts delete <id>       # Delete account
+mmoney accounts refresh           # Refresh from institutions
+mmoney accounts refresh-status    # Check refresh status
+```
+
+### Holdings
+```bash
+mmoney holdings list <account_id>     # List holdings
+mmoney holdings history <account_id>  # Balance history
+mmoney holdings snapshots             # Aggregate snapshots
+mmoney holdings balances              # Recent balances
+```
+
+### Transactions
+```bash
+mmoney transactions list              # List transactions
+mmoney transactions get <id>          # Get transaction details
+mmoney transactions summary           # Transaction summary
+mmoney transactions splits <id>       # Get splits
+mmoney transactions create            # Create transaction
+mmoney transactions update <id>       # Update transaction
+mmoney transactions delete <id>       # Delete transaction
+```
+
+### Categories
+```bash
+mmoney categories list      # List categories
+mmoney categories groups    # List category groups
+mmoney categories create    # Create category
+mmoney categories delete    # Delete category
+```
+
+### Tags
+```bash
+mmoney tags list                    # List tags
+mmoney tags create                  # Create tag
+mmoney tags set <transaction_id>    # Set tags on transaction
+```
+
+### Budgets
+```bash
+mmoney budgets list    # List budgets
+mmoney budgets set     # Set budget amount
+```
+
+### Cashflow
+```bash
+mmoney cashflow summary    # Income, expenses, savings
+mmoney cashflow details    # By category and merchant
+```
+
+### Other
+```bash
+mmoney recurring list       # Recurring transactions
+mmoney institutions list    # Linked institutions
+mmoney subscription status  # Subscription details
+```
+
+## Common Options
+
+Most list commands support filtering:
+- `--limit`, `-l`: Number of records
+- `--start-date`, `-s`: Start date (YYYY-MM-DD)
+- `--end-date`, `-e`: End date (YYYY-MM-DD)
+
+Example:
+```bash
+mmoney transactions list --limit 50 --start-date 2024-01-01 --end-date 2024-12-31
+```
+
+## Output
+
+All commands output JSON by default, making it easy to pipe to tools like `jq`:
+
+```bash
+mmoney accounts list | jq '.accounts[] | {name: .displayName, balance: .currentBalance}'
+```
+
+## Session Storage
+
+Sessions are stored in `.mm/mm_session.pickle` in the current directory.
+
+## Authentication Methods
+
+Recommended authentication methods in order of preference:
+
+1. **MFA Secret** (Best): Enable MFA in Monarch, copy the secret key when setting up your authenticator. Use `--mfa-secret` for fully automated, long-lasting auth
+2. **MFA Code**: Use `--mfa-code` with the 6-digit code from your authenticator app
+3. **Device UUID**: Get from browser console with `localStorage.getItem('monarchDeviceUUID')` and use `--device-uuid`
+4. **Token**: Get from browser Network tab (Authorization header) and use `--token` - shortest lived
+
+Run `mmoney auth login --help` for detailed instructions on each method.
+
+## License
+
+MIT

mmoney-0.1.0/README.md

@@ -0,0 +1,164 @@
+# mmoney-cli
+
+![CI](https://github.com/theFong/mmoney-cli/actions/workflows/ci.yml/badge.svg)
+
+> **Disclaimer:** This is an unofficial, community-built CLI tool. It is not affiliated with, endorsed by, or supported by Monarch Money. Use at your own risk.
+
+CLI for [Monarch Money](https://www.monarchmoney.com) - access your financial data from the command line.
+
+Built on top of [monarchmoneycommunity](https://github.com/bradleyseanf/monarchmoneycommunity).
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv tool install mmoney-cli
+
+# Or using pip
+pip install mmoney-cli
+```
+
+## Development
+
+```bash
+# Clone and install with uv
+git clone https://github.com/theFong/mmoney-cli.git
+cd mmoney-cli
+uv sync
+
+# Run CLI
+uv run mmoney --help
+```
+
+## Quick Start
+
+```bash
+# Best: Email + Password + MFA Secret (longest lasting, fully automated)
+# Enable MFA in Monarch settings, copy the secret key when setting up authenticator
+mmoney auth login -e your@email.com -p yourpassword --mfa-secret YOUR_SECRET --no-interactive
+
+# Good: Email + Password + MFA Code (requires manual code entry)
+mmoney auth login -e your@email.com -p yourpassword --mfa-code 123456
+
+# Alternative: Email + Password + Device UUID (requires browser)
+# 1. Open app.monarch.com, login, open DevTools Console
+# 2. Run: copy(localStorage.getItem('monarchDeviceUUID'))
+mmoney auth login -e your@email.com -p yourpassword --device-uuid YOUR_UUID --no-interactive
+
+# Fallback: Token from browser (shortest lived)
+# 1. Open app.monarch.com, login, open DevTools Network tab
+# 2. Click any 'graphql' request, find 'Authorization: Token YOUR_TOKEN' in Headers
+mmoney auth login --token YOUR_TOKEN
+```
+
+## Commands
+
+### Authentication
+```bash
+mmoney auth login      # Login to Monarch Money
+mmoney auth logout     # Delete saved session
+mmoney auth status     # Check authentication status
+```
+
+### Accounts
+```bash
+mmoney accounts list              # List all accounts
+mmoney accounts types             # List account types
+mmoney accounts create            # Create manual account
+mmoney accounts update <id>       # Update account
+mmoney accounts delete <id>       # Delete account
+mmoney accounts refresh           # Refresh from institutions
+mmoney accounts refresh-status    # Check refresh status
+```
+
+### Holdings
+```bash
+mmoney holdings list <account_id>     # List holdings
+mmoney holdings history <account_id>  # Balance history
+mmoney holdings snapshots             # Aggregate snapshots
+mmoney holdings balances              # Recent balances
+```
+
+### Transactions
+```bash
+mmoney transactions list              # List transactions
+mmoney transactions get <id>          # Get transaction details
+mmoney transactions summary           # Transaction summary
+mmoney transactions splits <id>       # Get splits
+mmoney transactions create            # Create transaction
+mmoney transactions update <id>       # Update transaction
+mmoney transactions delete <id>       # Delete transaction
+```
+
+### Categories
+```bash
+mmoney categories list      # List categories
+mmoney categories groups    # List category groups
+mmoney categories create    # Create category
+mmoney categories delete    # Delete category
+```
+
+### Tags
+```bash
+mmoney tags list                    # List tags
+mmoney tags create                  # Create tag
+mmoney tags set <transaction_id>    # Set tags on transaction
+```
+
+### Budgets
+```bash
+mmoney budgets list    # List budgets
+mmoney budgets set     # Set budget amount
+```
+
+### Cashflow
+```bash
+mmoney cashflow summary    # Income, expenses, savings
+mmoney cashflow details    # By category and merchant
+```
+
+### Other
+```bash
+mmoney recurring list       # Recurring transactions
+mmoney institutions list    # Linked institutions
+mmoney subscription status  # Subscription details
+```
+
+## Common Options
+
+Most list commands support filtering:
+- `--limit`, `-l`: Number of records
+- `--start-date`, `-s`: Start date (YYYY-MM-DD)
+- `--end-date`, `-e`: End date (YYYY-MM-DD)
+
+Example:
+```bash
+mmoney transactions list --limit 50 --start-date 2024-01-01 --end-date 2024-12-31
+```
+
+## Output
+
+All commands output JSON by default, making it easy to pipe to tools like `jq`:
+
+```bash
+mmoney accounts list | jq '.accounts[] | {name: .displayName, balance: .currentBalance}'
+```
+
+## Session Storage
+
+Sessions are stored in `.mm/mm_session.pickle` in the current directory.
+
+## Authentication Methods
+
+Recommended authentication methods in order of preference:
+
+1. **MFA Secret** (Best): Enable MFA in Monarch, copy the secret key when setting up your authenticator. Use `--mfa-secret` for fully automated, long-lasting auth
+2. **MFA Code**: Use `--mfa-code` with the 6-digit code from your authenticator app
+3. **Device UUID**: Get from browser console with `localStorage.getItem('monarchDeviceUUID')` and use `--device-uuid`
+4. **Token**: Get from browser Network tab (Authorization header) and use `--token` - shortest lived
+
+Run `mmoney auth login --help` for detailed instructions on each method.
+
+## License
+
+MIT

mmoney-0.1.0/mmoney.egg-info/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: mmoney
+Version: 0.1.0
+Summary: CLI for Monarch Money - access your financial data from the command line
+Author-email: Alec Fong <alecfong1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theFong/mmoney-cli
+Project-URL: Repository, https://github.com/theFong/mmoney-cli
+Project-URL: Issues, https://github.com/theFong/mmoney-cli/issues
+Keywords: monarch money,cli,finance,personal finance,budgeting
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: monarchmoneycommunity>=1.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: keyring>=24.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: vulture>=2.13; extra == "dev"
+Requires-Dist: pre-commit>=4.0.0; extra == "dev"
+Requires-Dist: detect-secrets>=1.5.0; extra == "dev"
+Dynamic: license-file
+
+# mmoney-cli
+
+![CI](https://github.com/theFong/mmoney-cli/actions/workflows/ci.yml/badge.svg)
+
+> **Disclaimer:** This is an unofficial, community-built CLI tool. It is not affiliated with, endorsed by, or supported by Monarch Money. Use at your own risk.
+
+CLI for [Monarch Money](https://www.monarchmoney.com) - access your financial data from the command line.
+
+Built on top of [monarchmoneycommunity](https://github.com/bradleyseanf/monarchmoneycommunity).
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv tool install mmoney-cli
+
+# Or using pip
+pip install mmoney-cli
+```
+
+## Development
+
+```bash
+# Clone and install with uv
+git clone https://github.com/theFong/mmoney-cli.git
+cd mmoney-cli
+uv sync
+
+# Run CLI
+uv run mmoney --help
+```
+
+## Quick Start
+
+```bash
+# Best: Email + Password + MFA Secret (longest lasting, fully automated)
+# Enable MFA in Monarch settings, copy the secret key when setting up authenticator
+mmoney auth login -e your@email.com -p yourpassword --mfa-secret YOUR_SECRET --no-interactive
+
+# Good: Email + Password + MFA Code (requires manual code entry)
+mmoney auth login -e your@email.com -p yourpassword --mfa-code 123456
+
+# Alternative: Email + Password + Device UUID (requires browser)
+# 1. Open app.monarch.com, login, open DevTools Console
+# 2. Run: copy(localStorage.getItem('monarchDeviceUUID'))
+mmoney auth login -e your@email.com -p yourpassword --device-uuid YOUR_UUID --no-interactive
+
+# Fallback: Token from browser (shortest lived)
+# 1. Open app.monarch.com, login, open DevTools Network tab
+# 2. Click any 'graphql' request, find 'Authorization: Token YOUR_TOKEN' in Headers
+mmoney auth login --token YOUR_TOKEN
+```
+
+## Commands
+
+### Authentication
+```bash
+mmoney auth login      # Login to Monarch Money
+mmoney auth logout     # Delete saved session
+mmoney auth status     # Check authentication status
+```
+
+### Accounts
+```bash
+mmoney accounts list              # List all accounts
+mmoney accounts types             # List account types
+mmoney accounts create            # Create manual account
+mmoney accounts update <id>       # Update account
+mmoney accounts delete <id>       # Delete account
+mmoney accounts refresh           # Refresh from institutions
+mmoney accounts refresh-status    # Check refresh status
+```
+
+### Holdings
+```bash
+mmoney holdings list <account_id>     # List holdings
+mmoney holdings history <account_id>  # Balance history
+mmoney holdings snapshots             # Aggregate snapshots
+mmoney holdings balances              # Recent balances
+```
+
+### Transactions
+```bash
+mmoney transactions list              # List transactions
+mmoney transactions get <id>          # Get transaction details
+mmoney transactions summary           # Transaction summary
+mmoney transactions splits <id>       # Get splits
+mmoney transactions create            # Create transaction
+mmoney transactions update <id>       # Update transaction
+mmoney transactions delete <id>       # Delete transaction
+```
+
+### Categories
+```bash
+mmoney categories list      # List categories
+mmoney categories groups    # List category groups
+mmoney categories create    # Create category
+mmoney categories delete    # Delete category
+```
+
+### Tags
+```bash
+mmoney tags list                    # List tags
+mmoney tags create                  # Create tag
+mmoney tags set <transaction_id>    # Set tags on transaction
+```
+
+### Budgets
+```bash
+mmoney budgets list    # List budgets
+mmoney budgets set     # Set budget amount
+```
+
+### Cashflow
+```bash
+mmoney cashflow summary    # Income, expenses, savings
+mmoney cashflow details    # By category and merchant
+```
+
+### Other
+```bash
+mmoney recurring list       # Recurring transactions
+mmoney institutions list    # Linked institutions
+mmoney subscription status  # Subscription details
+```
+
+## Common Options
+
+Most list commands support filtering:
+- `--limit`, `-l`: Number of records
+- `--start-date`, `-s`: Start date (YYYY-MM-DD)
+- `--end-date`, `-e`: End date (YYYY-MM-DD)
+
+Example:
+```bash
+mmoney transactions list --limit 50 --start-date 2024-01-01 --end-date 2024-12-31
+```
+
+## Output
+
+All commands output JSON by default, making it easy to pipe to tools like `jq`:
+
+```bash
+mmoney accounts list | jq '.accounts[] | {name: .displayName, balance: .currentBalance}'
+```
+
+## Session Storage
+
+Sessions are stored in `.mm/mm_session.pickle` in the current directory.
+
+## Authentication Methods
+
+Recommended authentication methods in order of preference:
+
+1. **MFA Secret** (Best): Enable MFA in Monarch, copy the secret key when setting up your authenticator. Use `--mfa-secret` for fully automated, long-lasting auth
+2. **MFA Code**: Use `--mfa-code` with the 6-digit code from your authenticator app
+3. **Device UUID**: Get from browser console with `localStorage.getItem('monarchDeviceUUID')` and use `--device-uuid`
+4. **Token**: Get from browser Network tab (Authorization header) and use `--token` - shortest lived
+
+Run `mmoney auth login --help` for detailed instructions on each method.
+
+## License
+
+MIT

mmoney-0.1.0/mmoney.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+mmoney.egg-info/PKG-INFO
+mmoney.egg-info/SOURCES.txt
+mmoney.egg-info/dependency_links.txt
+mmoney.egg-info/entry_points.txt
+mmoney.egg-info/requires.txt
+mmoney.egg-info/top_level.txt
+mmoney_cli/__init__.py
+mmoney_cli/cli.py
+tests/__init__.py
+tests/conftest.py
+tests/test_cli.py
+tests/test_cli_errors.py

mmoney-0.1.0/mmoney.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mmoney-0.1.0/mmoney.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mmoney = mmoney_cli.cli:cli

mmoney-0.1.0/mmoney.egg-info/requires.txt

@@ -0,0 +1,11 @@
+monarchmoneycommunity>=1.1.0
+click>=8.0.0
+keyring>=24.0.0
+
+[dev]
+pytest>=7.0.0
+black>=23.0.0
+ruff>=0.8.0
+vulture>=2.13
+pre-commit>=4.0.0
+detect-secrets>=1.5.0

mmoney-0.1.0/mmoney.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+dist
+docs
+mmoney_cli
+tests

mmoney-0.1.0/mmoney_cli/__init__.py

@@ -0,0 +1,3 @@
+"""mmoney-cli - CLI for Monarch Money."""
+
+__version__ = "0.1.0"