Skip to main content
Glama

frigo

La porte du frigo, version web : la liste d'épicerie, les tâches de la maison et les gros achats à planifier, pour deux personnes. Claude peut y ajouter des choses par un serveur MCP intégré.

Pour l'instant : la liste d'épicerie et son serveur MCP. Les tâches et les gros achats suivent.

Épicerie

  • Ajout en texte libre : « lait 2 L », « 3 oignons », « 1 lb bœuf haché #lasagne ». La quantité et les étiquettes (#recette) sont reconnues ; _ devient une espace dans une étiquette.

  • « Coller une liste » ajoute une ligne par article, avec une étiquette commune facultative.

  • Un article déjà à acheter n'est jamais dupliqué : la quantité s'ajoute (« 2 + 1 ») et les étiquettes se cumulent.

  • Un article coché reste barré jusqu'à « Vider les achetés ». Ceux qu'on ajoute souvent sont proposés en raccourci.

  • La page se met à jour toute seule quand l'autre personne modifie la liste.

  • « Toujours en stock » : les produits qu'on a toujours (achetés en vrac, par exemple). Claude ne les ajoute jamais, même pour une recette, sauf si on lui dit qu'il en manque. On peut toujours les ajouter soi-même.

Related MCP server: lista-compras-mcp

Serveur MCP

Sur /mcp (HTTP streamable, sans état), protégé par le jeton FRIGO_MCP_TOKEN. Sans jeton configuré, il est désactivé. Il ne passe pas par oauth2-proxy : Claude Code le joint directement.

Outil

Rôle

list_groceries

ce qu'il reste à acheter (et les achetés sur demande), filtrable par étiquette, plus les produits toujours en stock

add_groceries

ajoute des articles, avec une étiquette commune (ex. la recette) ; même fusion que l'interface. Laisse de côté les produits toujours en stock, sauf include_staples

update_grocery

change le nom, la quantité ou les étiquettes d'un article

mark_bought, remove_groceries, clear_bought

cocher, retirer, vider les achetés

Les articles ajoutés par le MCP portent une pastille « Claude » dans la liste. Les consignes données à Claude (une recette = un appel, réutiliser le nom d'un article équivalent) sont dans app/mcp_server.py.

claude mcp add --transport http frigo http://<hôte>:8000/mcp --header "Authorization: Bearer $FRIGO_MCP_TOKEN"

Lancer en local

python3.13 -m venv .venv && . .venv/bin/activate
pip install -r requirements-dev.txt
FRIGO_DEV_USER=Jacob uvicorn app.main:create_app --factory --reload

Ou avec l'image :

docker build -t frigo . && docker run --rm -p 8000:8000 -e FRIGO_DEV_USER=Jacob frigo

Configuration

Variable

Rôle

FRIGO_PEOPLE

JSON courriel → prénom : {"jacob@example.com": "Jacob"}

FRIGO_TRUSTED_PROXIES

IP autorisées à transmettre X-Email, séparées par des virgules (nginx)

FRIGO_DEV_USER

Développement seulement : saute l'identification, tout le monde est cette personne

FRIGO_MCP_TOKEN

Jeton du serveur MCP (openssl rand -hex 32). Vide : MCP désactivé

FRIGO_DATA_DIR

Dossier de la base SQLite (/app/data dans l'image)

L'identité vient de l'en-tête X-Email posé par oauth2-proxy. Il n'est accepté que d'une adresse de FRIGO_TRUSTED_PROXIES : sinon, n'importe qui joignant le port directement pourrait se faire passer pour l'un de nous. Uvicorn tourne avec --no-proxy-headers pour que l'adresse vérifiée soit bien celle de la connexion. Sans identité reconnue, tout répond 403, sauf /healthz, /static/ et /mcp, qui exige le jeton.

Vérifications

ruff check . && ruff format --check . && pytest

Publication

GitHub Actions lance le lint et les tests à chaque PR, construit l'image et la démarre pour un test de fumée. Après un merge dans main, l'image est publiée sur Docker Hub sous lams364/frigo:latest et lams364/frigo:sha-<commit>. Watchtower la récupère ensuite sur le serveur.

La publication demande un jeton Docker Hub (Account settings > Personal access tokens, Read & Write) dans les secrets du dépôt :

gh secret set DOCKERHUB_TOKEN -R jacoblamarche/frigo

Le déploiement (LXC, nginx, oauth2-proxy) vit dans iac-homelab.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • AnyList MCP server for ChatGPT, Claude and any AI agent: list shopping lists, add list item, cross off item, read recipe, create recipe, add recipe to meal plan and add meal plan ingredients to list in your own AnyList account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to AnyList yourself; Cotlet does not store your password and you need no AnyList API key. About the official AnyList API: AnyList has no public API, developer docs or official MCP server (checked 25 Oct 2026). The official connections are voice entry with Siri and Amazon Alexa, and an iCalendar link that shows your meal plan in a calendar app. Setup and FAQ: https://cotlet.dev/integrations/anylist-api-mcp-server

      https://cotlet.dev/mcp/v1/anylist
    • Read and edit your Kori grocery lists: add, check off, edit and remove items.

      https://mcp.getkori.fi
    • Brie connects your assistant to saved recipes, household meal plans and shared grocery lists. Search your recipe library, import recipe links or text, and save a higher-protein or vegetarian adaptation as a named recipe version while preserving the original source. Prepare dinners around your household's preferences, review the proposal, then save the plan and rebuild its groceries. Start with a Brie account on the web and activate your personal Plus or Pro plan, or an eligible trial. Existing subscribers use their current account. Plus starts at $4.99 USD/month, with a seven-day trial for eligible new subscribers; current pricing and renewal terms appear before payment. Household membership alone does not include personal assistant access. Household operations require OAuth and your permission for the selected household. Public discovery exposes tool descriptions only. Eight recipe and grocery tools are available by default; add X-Brie-Capabilities: planning-preview for the thirteen-tool catalog including reviewed meal planning. No private nutrition logs, grocery purchases or billing access. Website: https://withbrie.app Setup: https://withbrie.app/agents Create your account: https://app.withbrie.app/signup?intent=assistant OpenClaw installation: https://clawhub.ai/brie/plugins/brie-openclaw

      https://api.withbrie.app/mcp
    • Personal lists (groceries, trips, gifts, books) that your AI assistant can read and update.

      https://lizt.app/mcp

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Manage your Pantrist pantry, shopping list, recipes, and weekly meal plan from Claude. The server wraps the same public REST API that powers the iOS, Android, and web apps, so your changes show up in real time on every device. * "What's on my shopping list?" * "Add milk, eggs, and that brand of olive oil I had last week" * "What's expiring in the next three days?"
      14
      2
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage shopping lists and items (create, edit, delete, mark as purchased) via integration with a backend API.
      8
      -