The guide to your
digital cellar
Talk to Claude like you'd talk to a sommelier. Drop a photo, say what you want, Caveist does the rest.
Setup
Connect Caveist to your Claude app. You'll need the server URL and bearer token provided when you joined the beta.
Edit your Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"uncork": {
"url": "https://your-project.supabase.co/functions/v1/uncork",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
} Restart Claude Desktop. uncork should appear in your MCP servers.
Verify your setup
Ask Claude: "What wines do I have in my cellar?"
Adding wines
Drop a label photo, or just describe what you bought.
"Just bought this" + photo
OCRs label, enriches metadata, adds 1 bottle
"Picked up 6 bottles of Clos Mogador 2019"
Adds 6 bottles with full metadata
"Got a case from Vivino, €18 each" + photo
Adds 12 bottles with price + source
"Bought a magnum, storing in the garage"
Adds 1 bottle with format + location
Just bought 3 bottles of this at the wine shop for €22 each
Added 3 bottles of Domaine Weinbach Riesling Grand Cru Schlossberg 2020
Logging tastings
Tell Claude what you drank. Works for cellar bottles and wines you tried elsewhere.
"Drank this tonight, incredible" + photo
Logs tasting, finds cellar match, marks as drunk
"Glass of Puligny at the restaurant, 8/10"
Logs external tasting — stock untouched
"Opened the 2018 Barolo, paired with osso buco"
Finds bottle, marks drunk, logs pairing
"Tried this at a friend's, wouldn't buy it" + photo
Logs external tasting, records preference
Opened this tonight with côte de boeuf. 9.5/10, would buy again
Château Musar 2000 — found 2 in cellar, marked one as drunk.
Querying your cellar
Ask anything about what you have, what you've drunk, or what to open.
What should I open tonight? Seafood pasta.
Weinbach Riesling GC Schlossberg 2020
Alsace — acidity cuts through richness
Chablis 1er Cru Montée de Tonnerre 2019
Burgundy — drinking beautifully now
Vermentino di Gallura 2022
Sardinia — crisp and mineral
The Chablis — classic seafood pairing.
Wishlist
Save wines you want to try later — no purchase needed.
"Add this to my wishlist" + photo
"Want to try Krug Grande Cuvée someday"
"Remember this, the sommelier recommended it" + photo
Managing
Correct mistakes, update details, change bottle status.
"Actually that was a 2019, not 2018"
Updates vintage
"Gifted 2 bottles of the Barolo"
Marks as gifted, removes from stock
"Move the Champagne to the garage fridge"
Updates location
Tips & tricks
Photos work from any angle
Even partial labels. Claude does the OCR and web search.
Say the quantity
"3 bottles", "a case", "half case". Defaults to 1.
Mention context
Where you bought it, drank it, what you ate. All searchable.
Rate 0–10
Decimals OK. "8.5" or "8.5 out of 10" both work.
Cellar vs. external
"From my cellar" decrements stock. Otherwise logged as external.
Auto-enrichment
Claude web-searches every wine for region, grapes, appellation, drink window.