# matcha money

Develop your ritual for financial wellness.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add aequitas-labs/matcha-money

# Browse available tools
npx -y @smithery/cli@latest tool list aequitas-labs/matcha-money

# Get full schema for a tool
npx -y @smithery/cli@latest tool get aequitas-labs/matcha-money get_accounts

# Call a tool
npx -y @smithery/cli@latest tool call aequitas-labs/matcha-money get_accounts '{}'
```

## Direct MCP Connection

Endpoint: `https://matcha-money--aequitas-labs.run.tools`

## Tools (23)

- `get_accounts` — Get all financial accounts (bank accounts, credit cards, investments).
- `get_account` — Get detailed account information with optional balance history.
- `manage_accounts` — Create or update any manual account (checking, savings, credit card, loan, investment, etc.), reconcile balances, renam…
- `get_net_worth` — Get net worth data (current or historical). Use get_holdings for detailed investment data.
- `get_holdings` — Get detailed investment holdings with per-ticker gain/loss. Use view=by_account to see holdings grouped under each acco…
- `get_liabilities` — Get all credit card and loan accounts with detailed liability information (APR, minimum payment, due date, credit limit…
- `manage_holdings` — Create, update, delete, exclude, or include investment holdings. Exclude/include controls whether a holding is hidden f…
- `manage_manual_items` — Create, update, delete, or list manual banks for organizing manual accounts. Manual items are the equivalent of Plaid i…
- `get_transactions` — Get recent transactions with optional filters. For incremental sync, use modified_after to fetch only transactions chan…
- `manage_transactions` — Create, update, delete, split, or batch update transactions. Use mode to specify operation.
- `get_budget` — Get budget data: targets, analysis, or income. Use get_liabilities for debt details.
- `manage_budgets` — Set budget targets or transfer funds between categories/goals.
- `get_goals` — Get financial goals.
- `manage_goals` — Create, update, archive, or unarchive a savings goal. Provide goal_id to update an existing goal.
- `get_recurring_bills` — Get all recurring bills.
- `manage_recurring_bills` — Create, update, or delete a recurring bill. Provide bill_id to update/delete.
- `get_taxonomy` — Get all categories and tags.
- `manage_taxonomy` — Create, update, or delete a category or tag. Use type to specify which.
- `merge_tags` — Merge one tag into another. All transactions with the source tag will be re-tagged with the target tag, and the source …
- `get_alerts` — Smart alerts are coming soon. This feature is temporarily disabled while we build a better alert system.
- `get_rules` — Get all categorization rules for automatically categorizing transactions.
- `manage_rules` — Create, update, or delete a categorization rule. Provide rule_id to update/delete. At least one of set_category or add_…
- `run_rules` — Run categorization rules on all uncategorized transactions.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get aequitas-labs/matcha-money <tool-name>
```

## Prompts (7)

- `budget_architect` — Analyze spending behavior, find cash leaks, and build a custom budget based on your actual habits
- `sustainability_auditor` — Align your spending with sustainable and ethical shopping practices
- `goal_simulator` — Reality-check a major purchase with cash vs. financing scenarios
- `investment_analyst` — Review your portfolio for concentration risk, tax inefficiencies, and allocation issues
- `fire_planner` — Calculate your financial independence timeline based on your actual spending
- `debt_calculator` — Map all debt including hidden BNPL and build a payoff strategy
- `tax_prep` — Surface tax-relevant spending, find missed deductions, and get organized for tax season