# Send Monarch Money to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "monarch-money",
    "name": "Monarch Money",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/davideasaf/monarch-money",
    "canonicalUrl": "https://clawhub.ai/davideasaf/monarch-money",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/monarch-money",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=monarch-money",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "cli/client.ts",
      "cli/commands/accounts.ts",
      "cli/commands/auth.ts",
      "cli/commands/categories.ts",
      "cli/commands/doctor.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/monarch-money"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/monarch-money",
    "downloadUrl": "https://openagent3.xyz/downloads/monarch-money",
    "agentUrl": "https://openagent3.xyz/skills/monarch-money/agent",
    "manifestUrl": "https://openagent3.xyz/skills/monarch-money/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/monarch-money/agent.md"
  }
}
```
## Documentation

### Monarch Money

CLI and TypeScript library for Monarch Money budget automation.

### Environment Variables (Required)

VariableRequiredDescriptionMONARCH_EMAILYesMonarch Money account emailMONARCH_PASSWORDYesMonarch Money account passwordMONARCH_MFA_SECRETYesTOTP secret for MFA (see below)

### Getting Your MFA Secret

Monarch Money requires MFA. Generate the TOTP secret:

Login to https://app.monarchmoney.com
Go to Settings > Security > Two-Factor Authentication
If MFA is already enabled: disable and re-enable to get a new secret
When shown the QR code: click "Can't scan? View setup key"
Copy the secret key (base32 string like JBSWY3DPEHPK3PXP)
Complete MFA setup in Monarch Money with an authenticator app
Set the secret: export MONARCH_MFA_SECRET="YOUR_SECRET"

### Quick Start

# Check setup
monarch-money doctor

# Login (uses env vars by default)
monarch-money auth login

# List transactions
monarch-money tx list --limit 10

# List categories
monarch-money cat list

### Authentication

# Login with environment variables
monarch-money auth login

# Login with explicit credentials
monarch-money auth login -e email@example.com -p password --mfa-secret SECRET

# Check auth status
monarch-money auth status

# Logout
monarch-money auth logout

### Transactions

# List recent transactions
monarch-money tx list --limit 20

# Search by date
monarch-money tx list --start-date 2026-01-01 --end-date 2026-01-31

# Search by merchant
monarch-money tx list --merchant "Walmart"

# Get transaction by ID
monarch-money tx get <transaction_id>

# Update category
monarch-money tx update <id> --category <category_id>

# Update merchant name
monarch-money tx update <id> --merchant "New Name"

# Add notes
monarch-money tx update <id> --notes "My notes here"

### Categories

# List all categories
monarch-money cat list

# List with IDs (for updates)
monarch-money cat list --show-ids

### Accounts

# List accounts
monarch-money acc list

# Show account details
monarch-money acc get <account_id>

### Doctor (Diagnostics)

# Run diagnostic checks
monarch-money doctor

Checks:

Environment variables set
API connectivity
Session validity
Node.js version

### Library Usage

Import and use the TypeScript library directly:

import { MonarchClient } from 'monarch-money';

const client = new MonarchClient({ baseURL: 'https://api.monarch.com' });

// Login
await client.login({
  email: process.env.MONARCH_EMAIL,
  password: process.env.MONARCH_PASSWORD,
  mfaSecretKey: process.env.MONARCH_MFA_SECRET
});

// Get transactions
const transactions = await client.transactions.getTransactions({ limit: 10 });

// Get categories
const categories = await client.categories.getCategories();

// Get accounts
const accounts = await client.accounts.getAll();

### Find and Update a Transaction

# 1. Find the transaction
monarch-money tx list --date 2026-01-15 --merchant "Target"

# 2. Get category ID
monarch-money cat list --show-ids

# 3. Update the transaction
monarch-money tx update <transaction_id> --category <category_id>

### Search Transactions by Date Range

monarch-money tx list --start-date 2026-01-01 --end-date 2026-01-31 --limit 100

### Check Budget Status

monarch-money acc list

### Error Handling

ErrorSolution"Not logged in"Run monarch-money auth login"MFA code required"Set MONARCH_MFA_SECRET environment variable"Invalid credentials"Verify email/password work at app.monarchmoney.com"Session expired"Run monarch-money auth login again

### Session Management

Sessions are cached locally at ~/.mm/session.json. After initial login, subsequent commands reuse the saved session for faster execution.

To clear the session: monarch-money auth logout

### References

API.md - GraphQL API details and advanced usage
TROUBLESHOOTING.md - Common issues and solutions
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: davideasaf
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/monarch-money)
- [Send to Agent page](https://openagent3.xyz/skills/monarch-money/agent)
- [JSON manifest](https://openagent3.xyz/skills/monarch-money/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/monarch-money/agent.md)
- [Download page](https://openagent3.xyz/downloads/monarch-money)