# Hearth

> Plan meals, chores, home care, a move and trips for your whole household in one place. Hearth is a household planner that runs in your browser. Describe your household once — people, pantry, chores, home features, rooms, a move and your trips — and Hearth turns it into runs of seventeen usefulweb tools: a fridge check, recipe ideas and a weekly dinner plan with shopping list, fair chore rotations, a maintenance calendar and emergency kit, moving scenarios, furniture fit checks and room layouts, jet lag plans, connection odds, payment fees and a movie night. A dashboard, a two-week agenda, one calendar file with reminders, snapshots over time and a printable report bring it all together.

Hearth (Home & travel planner) is a premium app of usefulweb.site (https://usefulweb.site/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://hearth.usefulweb.site/
- Workspace (browser app): https://hearth.usefulweb.site/app - open a project with https://hearth.usefulweb.site/app#project=<base64url-encoded project JSON> or a template with https://hearth.usefulweb.site/app#template=<id>
- Project file format (JSON Schema): https://hearth.usefulweb.site/project.schema.json
- Tutorials: https://hearth.usefulweb.site/tutorials
- JSON API: POST https://hearth.usefulweb.site/api/v1/tools/<toolId>/calculate (catalog: https://hearth.usefulweb.site/api/v1/tools)
- OpenAPI: https://hearth.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://hearth.usefulweb.site/mcp

## Engine tools
- [Weekly Meal Planner](https://weeklymealplanner.usefulweb.site/): Turn your pantry and its expiry dates into a 7-day dinner plan and a shopping list. API: POST https://hearth.usefulweb.site/api/v1/tools/weekly-meal-planner/calculate · MCP tool `weekly_meal_planner`
- [Leftover Chef](https://leftoverchef.usefulweb.site/): Turn leftovers and fridge odds and ends into 5 recipe ideas, using what expires first. API: POST https://hearth.usefulweb.site/api/v1/tools/leftover-chef/calculate · MCP tool `leftover_chef`
- [Food Storage Guide](https://foodstorageguide.usefulweb.site/): How long is food safe in the fridge or freezer? Dates from the official FoodSafety.gov chart. API: POST https://hearth.usefulweb.site/api/v1/tools/food-storage-guide/calculate · MCP tool `food_storage_guide`
- [Household Chore Rotator](https://householdchorerotator.usefulweb.site/): Fair chore rotation by effort and availability, with per-person totals and a calendar. API: POST https://hearth.usefulweb.site/api/v1/tools/household-chore-rotator/calculate · MCP tool `household_chore_rotator`
- [Chore Roulette](https://choreroulette.usefulweb.site/): Spin a fair chore rota: random but balanced by effort, with a “not again” rule. API: POST https://hearth.usefulweb.site/api/v1/tools/chore-roulette/calculate · MCP tool `chore_roulette`
- [Household Maintenance Calendar](https://householdmaintenancecalendar.usefulweb.site/): A dated home maintenance schedule for your appliances and features, as a calendar file. API: POST https://hearth.usefulweb.site/api/v1/tools/household-maintenance-calendar/calculate · MCP tool `household_maintenance_calendar`
- [Disaster Prep Builder](https://disasterprepbuilder.usefulweb.site/): Build an emergency supply list for your household from official Ready.gov or BBK guidance. API: POST https://hearth.usefulweb.site/api/v1/tools/disaster-prep-builder/calculate · MCP tool `disaster_prep_builder`
- [Moving Box Planner](https://movingboxplanner.usefulweb.site/): How many moving boxes, how much tape, which truck and when to start packing. API: POST https://hearth.usefulweb.site/api/v1/tools/moving-box-planner/calculate · MCP tool `moving_box_planner`
- [Will It Fit?](https://willitfit.usefulweb.site/): Check if a sofa, wardrobe or box fits through doors, corners, stairs and lifts. API: POST https://hearth.usefulweb.site/api/v1/tools/will-it-fit/calculate · MCP tool `will_it_fit`
- [Room Layout Optimizer](https://roomlayoutoptimizer.usefulweb.site/): Auto-arrange furniture in a room around doors, windows and a clear walkway. API: POST https://hearth.usefulweb.site/api/v1/tools/room-layout-optimizer/calculate · MCP tool `room_layout_optimizer`
- [Jet Lag Planner](https://jetlagplanner.usefulweb.site/): A day-by-day sleep, light and caffeine plan to beat jet lag, with calendar export. API: POST https://hearth.usefulweb.site/api/v1/tools/jet-lag-planner/calculate · MCP tool `jet_lag_planner`
- [Travel Connection Checker](https://travelconnectionchecker.usefulweb.site/): Estimate your odds of making a flight connection, step by step. API: POST https://hearth.usefulweb.site/api/v1/tools/travel-connection-checker/calculate · MCP tool `travel_connection_checker`
- [Currency Converter](https://currencyconverter.usefulweb.site/): Convert an amount into several currencies at ECB euro reference rates, with rate date and source. API: POST https://hearth.usefulweb.site/api/v1/tools/currency-converter/calculate · MCP tool `currency_converter`
- [Travel Exchange Fee Calculator](https://travelexchangefeecalculator.usefulweb.site/): Compare what cards, ATMs, DCC and exchange bureaus really cost abroad vs the ECB reference rate. API: POST https://hearth.usefulweb.site/api/v1/tools/travel-exchange-fee-calculator/calculate · MCP tool `travel_exchange_fee_calculator`
- [Tip & Bill Split Calculator](https://tipbillsplitcalculator.usefulweb.site/): Tip, tax and who pays what: split a bill equally, by shares or by items, rounded up. API: POST https://hearth.usefulweb.site/api/v1/tools/tip-bill-split-calculator/calculate · MCP tool `tip_bill_split_calculator`
- [Movie Night Consensus Picker](https://movienightconsensuspicker.usefulweb.site/): Everyone ranks the films, vetoes count: Borda, approval, runoff and Condorcet decide. API: POST https://hearth.usefulweb.site/api/v1/tools/movie-night-consensus-picker/calculate · MCP tool `movie_night_consensus_picker`
- [Movie & Series Marathon Planner](https://runtimemarathonplanner.usefulweb.site/): Plan a binge: when each movie or episode starts and ends, total days, and a calendar. API: POST https://hearth.usefulweb.site/api/v1/tools/runtime-marathon-planner/calculate · MCP tool `runtime_marathon_planner`

## Formats
- Import: Hearth project (.hearth.json), Tables (CSV/TSV) into pantry, chores, furniture or films, Room photo or plan (PNG, JPEG, WebP), Project link (#project=…), App Bridge: tables and images from other apps
- Export: Hearth project (.hearth.json), Household calendar (.ics) with reminders, Tool calendars (.ics): chore rotation, maintenance, jet lag, marathon, Shopping list, chore plan, pantry and fit check (CSV), Report (Markdown and print/PDF), Floor plans (SVG and PNG), App Bridge: tables and Markdown to other apps

## Limits
- Hearth plans with the published rules of thumb of each tool; it does not know your actual fridge temperature, your flight’s live status or your mover’s quote.
- Running tools needs an internet connection; the tools are rate limited, so very large batches run with short pauses.
- Recipes come from the tools’ built-in recipe sets; you cannot add your own recipes.
- Room layouts are rectangular rooms with furniture as rectangles; L-shaped rooms, radiators and sloped ceilings are not modelled.
- The fit check treats furniture as a rigid box; it does not model tilting around a corner on stairs beyond what the Will It Fit? tool covers.
- Time zones for jet lag plans are limited to the zones the Jet Lag Planner offers.
- Reminders in the calendar file are suggestions for your calendar app; Hearth itself does not send notifications.
- There is no shared live editing; share a link or a project file instead.