pp-monarch-money

Monarch Money — Printing Press CLI

前提条件：CLI をインストールする

このスキルは monarch-money-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。デフォルトでは、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install monarch-money --cli-only
   

2. 確認します：monarch-money-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx でのインストールに失敗した場合（Node がない、オフラインなど）は、Go で直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/payments/monarch-money/cmd/monarch-money-pp-cli@latest

インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認に成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

次の内容についてユーザーから質問された場合に、この CLI を使用してください。

• Monarch Money の口座残高
• Monarch Money の取引タグ
• Monarch の最近の取引または日付で絞り込んだ取引
• 月次または任意の期間のキャッシュフロー
• 特定の Monarch の取引の作成、更新、タグ付け、削除
• 特定の読み取り専用 Monarch GraphQL クエリ

ルールの変更、口座の更新、予算の変更、広範なリモート書き込みには使用しないでください。取引の書き込みには、明示的な専用コマンドのみを使用できます。これらのコマンドはデフォルトでドライランを実行し、適用には --yes が必要です。

認証

CLI は保存済みセッションまたは環境トークンに対応しています。シェルの履歴にシークレットを直接入力するのではなく、環境変数を使用してください。

MONARCH_EMAIL='[email protected]' MONARCH_PASSWORD='...' monarch-money-pp-cli login

MFA が必要な場合：

MONARCH_EMAIL='[email protected]' MONARCH_PASSWORD='...' monarch-money-pp-cli login --mfa 123456

既存のトークンを設定する方法もあります。

export MONARCH_TOKEN='...'

その後、確認します。

monarch-money-pp-cli doctor

独自の機能

これらの機能は、Monarch データへの汎用シェルアクセスでは利用できません。

• query — GraphQL のミューテーションを含むファイルを拒否しながら、カスタムの読み取り専用 GraphQL クエリファイルを実行します。

  組み込みの口座、タグ、取引、キャッシュフローの各コマンドでは範囲が狭すぎるものの、ワークフローで読み取り専用のガードが必要な場合に使用します。

monarch-money-pp-cli query query.graphql --operation OperationName --variables '{"limit":10}'

• 取引の CRUD コマンド — 範囲を限定したミューテーションコマンドで、個別の取引を作成、更新、タグ付け、削除します。

  ユーザーが対象の取引を特定した後の取引整理に使用します。まず --yes を省略して、ドライランのペイロードを確認してください。

monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'Reviewed'
monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'Reviewed' --yes

おすすめのコマンド対応表

• 「Monarch に接続されていますか？」→ monarch-money-pp-cli status
• 「口座残高を表示して」→ monarch-money-pp-cli accounts
• 「どのようなタグがありますか？」→ monarch-money-pp-cli tags --limit 200
• 「最近の取引」→ monarch-money-pp-cli transactions --days 30 --limit 50
• 「今月のキャッシュフロー」→ monarch-money-pp-cli cashflow
• 「1月のキャッシュフロー」→ monarch-money-pp-cli cashflow --start 2026-01-01 --end 2026-01-31
• 「この取引のメモを更新して」→ monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'NOTE' を実行し、確認後に --yes を付けて再実行します。
• 「この取引にこれらのタグを付けて」→ monarch-money-pp-cli transactions set-tags TRANSACTION_ID --tag-id TAG_ID を実行し、確認後に --yes を付けて再実行します。
• 「分析用に生の出力が必要」→ --json を追加します。

コマンドリファレンス

accounts — 金融口座を残高、口座種別、金融機関とともに一覧表示します。

• monarch-money-pp-cli accounts — 口座残高を表形式で一覧表示します。
• monarch-money-pp-cli accounts --limit 10 — 最初の10件の口座を表示します。
• monarch-money-pp-cli accounts --json — GraphQL の生の口座ペイロードを返します。

tags — 家計の取引タグと取引件数を一覧表示します。

• monarch-money-pp-cli tags — タグと取引件数を一覧表示します。
• monarch-money-pp-cli tags --search travel --limit 20 — 名前でタグを検索します。

transactions — 日付、加盟店、カテゴリ、口座、金額、タグとともに最近の取引を一覧表示します。

• monarch-money-pp-cli transactions — デフォルトの30日間を対象に最近の取引を一覧表示します。
• monarch-money-pp-cli transactions --days 7 --limit 25 — より短い期間の最近の取引を一覧表示します。
• monarch-money-pp-cli transactions --start 2026-01-01 --end 2026-01-31 --json — 指定した期間のデータを JSON 形式で返します。
• monarch-money-pp-cli transactions --tag-id TAG_ID — Monarch のタグ ID で絞り込みます。

transactions create — 手動で取引を作成します。--yes を指定しない場合はドライランを実行します。

• monarch-money-pp-cli transactions create --date 2026-01-15 --account-id ACCOUNT_ID --amount -42.50 --merchant 'Coffee Shop' --category-id CATEGORY_ID — 作成ミューテーションをプレビューします。
• ドライランのペイロードを確認した後、適用するには --yes を追加します。

transactions update — ID で取引を更新します。--yes を指定しない場合はドライランを実行します。

• monarch-money-pp-cli transactions update TRANSACTION_ID --category-id CATEGORY_ID --notes 'Reviewed' — 取引の更新をプレビューします。
• 対応する更新フラグには、--category-id、--merchant、--goal-id、--amount、--date、--hide-from-reports true|false、--needs-review true|false、--notes があります。

transactions set-tags — 取引のすべてのタグを置き換えます。--yes を指定しない場合はドライランを実行します。

• monarch-money-pp-cli transactions set-tags TRANSACTION_ID --tag-id TAG_ID --tag-id ANOTHER_TAG_ID — タグの置き換えをプレビューします。
• monarch-money-pp-cli transactions set-tags TRANSACTION_ID --clear — タグのクリアをプレビューします。

transactions delete — ID で取引を削除します。--yes を指定しない場合はドライランを実行します。

• monarch-money-pp-cli transactions delete TRANSACTION_ID — 取引の削除をプレビューします。

cashflow — 指定した期間の収入、支出、純貯蓄額、貯蓄率を要約します。

• monarch-money-pp-cli cashflow — 今月の状況を要約します。
• monarch-money-pp-cli cashflow --start 2026-01-01 --end 2026-01-31 — 指定した期間の状況を要約します。

query — 高度なワークフローやデバッグ用に、ファイルから読み取り専用の GraphQL クエリを実行します。

• monarch-money-pp-cli query query.graphql --operation OperationName --variables '{"limit":10}' — 読み取り専用のクエリファイルを実行します。

doctor — ローカル設定と Monarch への接続を確認します。

• monarch-money-pp-cli doctor — 認証と接続を検証します。

status — 読み取り専用の GraphQL リクエストを実行して、現在の Monarch Money セッションを検証します。

• monarch-money-pp-cli status — 現在のセッションから Monarch に接続できることを確認します。

安全上の注意

取引を書き込むコマンドはデフォルトでドライランを実行し、Monarch にミューテーションを送信する前に --yes が必要です。書き込みには取引 ID を使用してください。加盟店名や金額から対象を推測してはいけません。

高度な query コマンドは、mutation を含む GraphQL ファイルの実行を拒否します。書き込みを回避する手段として使用しないでください。

MONARCH_TOKEN、保存されたセッションの内容、メールアドレスやパスワードの値、生の認証レスポンスを出力または公開しないでください。