# Lika Rika

Manage shared household finances for two people. Track expenses, income, budgets, savings goals, and settlements. Supports multiple splitting models: 50/50, proportional by income, and equal remainin…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add likarika/budget

# Browse available tools
npx -y @smithery/cli@latest tool list likarika/budget

# Get full schema for a tool
npx -y @smithery/cli@latest tool get likarika/budget list_groups

# Call a tool
npx -y @smithery/cli@latest tool call likarika/budget list_groups '{}'
```

## Direct MCP Connection

Endpoint: `https://budget--likarika.run.tools`

**Required config:**
- `x-api-key` (header) — API key created under Settings > API Keys at https://likarika.se (starts with gek_)

## Tools (24)

- `list_groups` — List all groups the authenticated user belongs to
- `get_group_summary` — Get a detailed summary of a group including members, settings, and current month expense totals
- `list_categories` — List all categories for a group, sorted by sort_order, with parent category info for hierarchy
- `add_expense` — Add a new expense to a group
- `list_expenses` — List expenses for a group, optionally filtered by month, category, or person
- `update_expense` — Update an existing expense
- `delete_expense` — Delete an expense from a group
- `add_income` — Add a new income record to a group
- `list_income` — List income records for a group in a given month
- `update_income` — Update an existing income record
- `delete_income` — Delete an income record from a group
- `add_budget_item` — Add a new budget item to a group
- `list_budget_items` — List all budget items for a group, with category names expanded
- `update_budget_item` — Update an existing budget item
- `delete_budget_item` — Delete a budget item from a group
- `get_budget_vs_actual` — Compare budgeted amounts against actual expenses for a group in a given month
- `list_saving_goals` — List all saving goals for a group, including current progress calculations
- `add_saving_goal` — Add a new saving goal to a group
- `update_saving_goal` — Update an existing saving goal
- `delete_saving_goal` — Delete a saving goal from a group
- `add_saving_withdrawal` — Record a withdrawal from a saving goal
- `delete_saving_withdrawal` — Delete a saving withdrawal record
- `get_settlement_status` — Calculate the settlement status for a group in a given month. Shows who owes whom based on expenses and income. Read-on…
- `create_settlement` — Create a settlement record for a group month. Also creates transfer records in both parties' personal budgets.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get likarika/budget <tool-name>
```