# Shared shopping list planner

- Human page: https://happytails.ai/en/calculators/shared-shopping-list-planner/
- Markdown: https://happytails.ai/en/calculators/shared-shopping-list-planner.md
- Structured JSON: https://happytails.ai/agents/en/calculators/shared-shopping-list-planner/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `shared-shopping-list-planner` |
| Category | calculators |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Lists are combined on this device for up to 250 items. Similar names are flagged for you to check, never merged.

### Inputs and settings

Text input: Shopping items as CSV, or a backup file.

Example or placeholder shown in the interface (not a validated fixture):

```text
name,quantity,category,list
```

Quantities can be a count or use g, kg, ml or l. Category and list are optional. Up to 400,000 characters. Review the settings before running.

No additional settings are declared for this tool.

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Up to 250 rows and 100,000 characters of CSV, or a backup file of up to 500 records and 400,000 characters made by this tool. Item names up to 80 characters. Everything is calculated on your device. Downloads: plain text list, JSON report, CSV and a JSON backup.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "shared-shopping-list-planner",
  "category": "calculators",
  "built": true,
  "requirements": "Up to 250 rows and 100,000 characters of CSV, or a backup file of up to 500 records and 400,000 characters made by this tool. Item names up to 80 characters. Everything is calculated on your device. Downloads: plain text list, JSON report, CSV and a JSON backup.",
  "implementation": {
    "fields": [],
    "registrationFamily": "everyday-record-trackers",
    "inputMaxLength": 400000,
    "inputErrorCode": "EVERYDAY_RECORD_TRACKERS_TOO_LONG",
    "note": "Lists are combined on this device for up to 250 items. Similar names are flagged for you to check, never merged.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 400000,
      "inputMode": "text",
      "label": "Shopping items as CSV, or a backup file",
      "placeholder": "name,quantity,category,list",
      "help": "Quantities can be a count or use g, kg, ml or l. Category and list are optional. Up to 400,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Combine shopping lists from several people into one list grouped by category, adding up matching items and flagging similar names for you to check.

### How to use Shared shopping list planner

1. Paste every item with its name, quantity, category and whose list it came from.
2. Use quantities like 2, 500 g, 1 kg, 250 ml or 1 l, or leave them empty.
3. Review the combined list and the names flagged as possible duplicates.
4. Copy the plain list, or download the CSV, report or backup.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

## Useful next steps

- [Recipe scaler](https://happytails.ai/en/calculators/recipe-scaler/) ([Markdown](https://happytails.ai/en/calculators/recipe-scaler.md))

- [Recipe cost calculator](https://happytails.ai/en/calculators/recipe-cost-calculator/) ([Markdown](https://happytails.ai/en/calculators/recipe-cost-calculator.md))

- [CSV remove duplicates](https://happytails.ai/en/data-tools/csv-remove-duplicates/) ([Markdown](https://happytails.ai/en/data-tools/csv-remove-duplicates.md))

## What counts as the same item

Names are compared after ignoring capital letters, punctuation and simple plurals, so Tomatoes and tomato match. Matching items are added up exactly in grams, millilitres or counts. Items with no quantity are kept and marked, never guessed.

### Possible duplicates

Names one letter apart, or the same item listed in different kinds of units, are flagged for you to check. They are never merged automatically.

### Keeping your records

Nothing is uploaded. Every result includes a backup file. Paste or open that backup later to pick up where you left off, because records kept in a browser can be lost when site data is cleared.