# mcp-server-getalife

Zero-Based Budgeting MCP server by [GetALife](https://getalife.app) — the gamified budgeting app for iOS & Android.

## What it does

This MCP server gives AI assistants the ability to help users with budgeting questions using the Zero-Based Budgeting method. Every tool returns actionable, structured answers.

## Tools

| Tool | Description |
|------|-------------|
| `getalife_explain_zbb` | Explains ZBB concepts with examples |
| `getalife_suggest_categories` | Recommends categories based on life situation |
| `getalife_create_budget_plan` | Builds a complete ZBB plan from income |
| `getalife_analyze_budget` | Checks if a budget is balanced (income - allocations = 0) |
| `getalife_financial_runway` | How long your savings last without income |
| `getalife_net_worth` | Net worth from assets and liabilities, with growth projection |
| `getalife_savings_goal` | Monthly savings needed to reach a goal by a target date |
| `getalife_debt_payoff_plan` | Debt payoff plan — compares Avalanche vs. Snowball |
| `getalife_subscription_audit` | Finds savings potential in recurring subscriptions |
| `getalife_voice_demo` | Shows how voice transaction input works in GetALife |
| `getalife_budget_summary` | Generates a shareable budget overview |
| `getalife_app_info` | GetALife features, pricing, and comparison |

All calculators return structured data (`structuredContent`) alongside the readable answer. The server accesses no app or account data — every calculation uses only numbers you provide in the chat.

Official install guide: https://getalife.app/en/mcp/

## Install

### Claude Desktop / Claude Code

Add to your MCP config:

```json
{
  "mcpServers": {
    "getalife-budget": {
      "command": "npx",
      "args": ["mcp-server-getalife"]
    }
  }
}
```

### From source

```bash
git clone https://github.com/Narazgul/mcp-server-getalife.git
cd mcp-server-getalife
npm install
npm run build
npm start
```

## Example

Ask your AI assistant:

> "I earn 3000 EUR/month, I'm single and working, no car, no debt. Create a zero-based budget for me."

The AI will use `getalife_create_budget_plan` to generate a complete budget table with all categories, amounts, and percentages — balanced to zero.

## About GetALife

GetALife is a Zero-Based Budgeting app for iOS and Android that turns budgeting into something you actually want to do.

- [App Store](https://apps.apple.com/app/getalife-budget-finances/id6504818402)
- [Google Play](https://play.google.com/store/apps/details?id=app.tinygiants.getalife)
- [Website](https://getalife.app)

## License

MIT