Skip to main content
Glama
AnmolGarg8

ZeroWaste Kitchen

by AnmolGarg8
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

ZeroWaste Kitchen - an Alexa+ MCP server that remembers your food

The gap: Alexa+ can reason about recipes, but it has no memory of what is actually in your kitchen or when it expires. ZeroWaste Kitchen is a small, fast MCP server that gives Alexa+ that memory, so it can say "your chicken expires tomorrow, cook it first" and "you only need to buy onion and cream."

Built for the Build, Ship, Shape: Amazon Developer Hackathon (Alexa+ track).

How it fits Alexa+

  • Alexa+ is the brain, we are the memory. Alexa+ handles language, reasoning and recipe ideas. This server is the household's system of record. No LLM calls in the request path.

  • MCP spec 2025-11-25 over Streamable HTTP (stateless, JSON responses).

  • Fast: every tool returns in ~10 ms locally (Alexa+ requires < 500 ms round trip). Enforced by a test.

  • Voice-first output: every result has a short, speakable summary plus structured data.

Related MCP server: FreshKeep MCP Server

Tools

Tool

What it does

add_items

Log groceries; expiry estimated from a shelf-life table (or stated by the user)

whats_expiring

Food expiring within N days, soonest first

use_items

Mark items as used (cooked) or wasted

shopping_gap

Given a recipe's ingredients: what you have vs. what to buy

waste_report

Items used before expiry vs. wasted, with money saved/wasted

Run it

python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python -m zerowaste.server            # serves http://127.0.0.1:8000/mcp and http://127.0.0.1:8000/
python demo/alexa_sim.py              # in a second terminal: simulated Alexa+ conversation
pytest -q                             # unit + end-to-end tests (real HTTP, official MCP client)

After starting the server, open http://127.0.0.1:8000/ for the interactive web simulator to chat with Alexa+, monitor live MCP JSON-RPC protocol requests in real-time, and watch your kitchen pantry update.

Env vars: ZW_PORT, ZW_HOST, ZW_DB (SQLite path), ZW_STORE (sqlite or dynamodb), ZW_TABLE (DynamoDB table), ZW_HOUSEHOLD (household ID), ZW_CURRENCY (symbol for spoken amounts).

Deploy to AWS Serverless

The server is deployment-ready and tested against a mocked DynamoDB, but not deployed. When you are ready to deploy, run:

sam build && sam deploy --guided

This deploys the FastMCP server with an HTTPS Function URL (serves /mcp for Alexa+ and / for the web simulator) on AWS Lambda and on-demand DynamoDB, which is expected to cost cents or less at demo scale; actual cost depends on the account's free-tier status. For the full architecture diagram, cost breakdown, safety settings, and instructions, see docs/AWS_ARCHITECTURE.md.

About the Alexa+ simulation (read this)

The author has no Alexa+ device or Alexa+ developer account, so the demo uses demo/alexa_sim.py, a scripted simulator that plays the role Alexa+ plays: connect as an MCP client, discover tools, map a spoken request to a tool call, speak the summary. The server itself is a real MCP server and is not coupled to the simulator; the same endpoint can be registered as an Alexa+ add-on.

Known limits

  • Single household (real use needs account linking / OAuth to scope data per user).

  • Shelf-life values are conservative rules of thumb; swap in USDA FoodKeeper for production.

  • DynamoDB single-table storage available for serverless; SQLite remains default for local development.

License: MIT

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • FreshKeep MCP Server

    THEMIGHTYBULL
    A
    license
    Not graded
    quality
    C
    maintenance
    Gives Alexa+ persistent, structured memory of a household kitchen: tracking purchased groceries, flagging items at risk of spoiling, proposing rescue meals from expiring ingredients, and maintaining shopping lists, receipt ingestion, and waste reports through MCP tool calls. Storage, tool logic, and safety controls (consent gates, two-step deletion, rate limiting) are exposed over Streamable HTTP for any MCP client.
    MIT

  • Pantry Pal

    subhamsaha8
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Alexa+ to manage a household pantry by voice, including adding and using items, tracking expirations, suggesting meals, and maintaining a shopping list.
    MIT

  • Sous

    getmohanraj95
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables an Alexa+ voice or text client to act as a sous-chef: it tracks the ingredients, dietary restrictions and allergies in your pantry, ranks recipes by what you already have and reports missing items, builds shopping lists, and schedules meals on a plan for natural-language times. It returns structured results so clients can render visual cards alongside spoken replies.
    MIT