Metadata-Version: 2.4
Name: cli-monarch
Version: 0.1.0
Summary: Standalone Monarch Money CLI and Python client
Author-email: Luke Steuber <luke@lukesteuber.com>
License: MIT
Project-URL: Homepage, https://github.com/lukeslp/cli-monarch
Project-URL: Repository, https://github.com/lukeslp/cli-monarch
Project-URL: Issues, https://github.com/lukeslp/cli-monarch/issues
Keywords: monarch-money,personal-finance,cli,budgets,transactions
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.4
Requires-Dist: gql>=4.0
Requires-Dist: oathtool>=2.3.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: mcp>=0.9.0
Dynamic: license-file

# cli-monarch

Standalone Monarch Money CLI and Python client.

This repository is a standalone extraction of the local Monarch tooling previously kept inside `geepers-kernel`. It preserves the existing `mm` command, keeps the Python client import path as `monarchmoney`, and adds a `monarch` console alias.

## Status

- Distribution/package name: `cli-monarch`
- Python import package: `monarchmoney`
- Console commands: `mm`, `monarch`

## Installation

### From PyPI (once published)

```bash
pip install cli-monarch
```

### From source

```bash
git clone https://github.com/lukeslp/cli-monarch.git
cd cli-monarch
python3 -m pip install -e .
```

### Verify

```bash
mm --help
monarch --help
```

## Quick Start

```bash
mm login
mm accounts
mm transactions list --limit 25
mm budgets summary
mm insights analyze
```

## Project Layout

```text
cli-monarch/
├── monarchmoney/    # Core Monarch client library
├── cli/             # Click-based CLI
├── mcp_server/      # Optional MCP server wrapper
├── tests/           # Test suite
└── .github/workflows/
```

## Notes

- This repo is derived from the upstream `hammem/monarchmoney` project plus local CLI and MCP additions.
- The new repository identity is intentionally separate from the upstream package to avoid publishing collisions.
- The CLI stores encrypted session data in `~/.mm/`.
