ShelfLife MCP
Integrates with Amazon Alexa+ to provide a live household food inventory, expiry warnings, use-it-up meal suggestions, grocery list management, and kitchen statistics through voice or chat interactions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ShelfLife MCPwhat's expiring in my fridge this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ShelfLife MCP ๐ฅฌโฐ
An MCP server that gives Alexa+ a live household food inventory โ expiry warnings, use-it-up recipes, and grocery lists โ built to end the "I forgot it was in the fridge" economy.
Track: Alexa+ (self-hosted MCP server, spec 2025-11-25, Streamable HTTP) ยท Mini-challenges: Open Source + AWS Builder
Built for the Build, Ship, Shape: Amazon Developer Hackathon.
node server/index.js # zero npm dependencies, Node 18+
โ MCP endpoint http://localhost:8931/mcp
โ Alexa+ sim http://localhost:8931/simulator/Why
~1/3 of food produced is wasted, and a huge slice of household waste is simply food that expired unnoticed. Voice assistants already sit in the kitchen โ but they can't see your pantry. ShelfLife fixes that: talk to it like Alexa, and it knows what you own, what's dying, and what to cook tonight.
Related MCP server: household-agent
What's in the box
Piece | What it is |
| Isomorphic MCP core: 9 tools (pantry CRUD, expiry radar, use-it-up meal suggestions, grocery list) + a JSON-RPC 2.0 / MCP message handler |
| Self-hosted MCP server โ Streamable HTTP transport ( |
| Simulated Alexa+ experience โ browser chat + voice (Web Speech API) that runs the same core through real |
| Optional AWS Builder integration: enriches |
Alexa+ integration (the track requirement)
The MCP server implements Streamable HTTP with protocol-version negotiation (
2025-11-25/2025-06-18/2025-03-26),initialize,notifications/initialized,ping,tools/list,tools/call, andMcp-Session-Idโ seeserver/index.js:handlePostMcp().Point any MCP client at it:
curl -X POST http://localhost:8931/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'The simulator is the "simulated Alexa+ experience" path done properly: it is not a mock โ it executes the identical JSON-RPC handshake (
initialize โ notifications/initialized โ tools/call) against the identical core the HTTP server serves.
Tools
pantry_add_item ยท pantry_list ยท pantry_check_expiry ยท pantry_remove_item ยท suggest_meals ยท grocery_add ยท grocery_list ยท grocery_remove ยท kitchen_stats
Design notes
Explainable urgency:
pantry_check_expiryranks by real date math;suggest_mealsscores recipes by how much expiring food they consume โ no black box.One core, two transports: the browser demo and the HTTP server cannot drift apart, because they literally share
core/mcp-core.js.Zero-dependency server: a pantry volunteer (or you) can run this on a potato. Persistence is a human-readable JSON file (
data/pantry.json).
Demo
Open the simulator and try: "what's expiring?" โ "what can I cook tonight?" โ "I bought 2 kilos of chicken" โ "add milk to the shopping list" โ "kitchen summary". Flip to the protocol panel to watch each utterance become an MCP tools/call.
License
MIT โ see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
No tool schema history has been recorded yet.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
AI-powered kitchen management โ pantry, recipes, meal plans, shopping lists
Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.
AI meal plans that fill your Kroger/Instacart cart - pantry-aware lists, all from chat.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceHousehold-aware kitchen brain for AI agents: manage pantry inventory with freshness tracking, shopping lists, recipe collections with cook notes and per-diner ratings, dietary profiles with allergen safety, and kitchen equipment โ all through 27 tools with OAuth 2.1 authentication. Includes a free tool for ingredient-based recipe generation without an account (accounts are free!).MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered household management including inventory tracking, restock predictions, meal planning from available ingredients, and baby supply monitoring through natural language commands.Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search recipes, compose nutritionally balanced meals, optimize weekly meal plans based on macro targets for family members, and generate consolidated grocery lists from a personal recipe database.-
- FlicenseAqualityBmaintenanceEnables users to manage their fridge inventory by listing, adding, removing, checking items, and identifying expiring items, as well as getting dinner ideas from available ingredients.5-
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/renhongtao2-cell/shelflife-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server