CellarTracker

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/slavins-co-cellartracker-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

11 read · 1 write · 1 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (13)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• bottle-detailsBottle Detailsread-only

  Look up individual bottles from the Bottles table — the per-bottle view spanning both in-cellar and consumed bottles, with barcode, exact location/bin, and size. Filter by wine name, location, bin, size, or barcode; set state to 'cellar' (default 'all' includes consumed). If the user attaches a photo of a bottle or its barcode, read the barcode digits from the image and pass them as the barcode filter. Location and Bin are account-specific labels, not physical descriptions — if a location/bin filter finds nothing, use cellar-stats with group_by=location or group_by=bin to see the actual values…

• cellar-statsCellar Statisticsread-only

  Get cellar statistics: total bottles, value, unique wines, and optional breakdowns. Valid group_by options: color, country, region, varietal, location, bin, category.

• clear-user-dataClear User Datacan change or delete data

  Remove stored CellarTracker credentials and cached wine data from this machine. Use this to fully disconnect your account or free up disk space.

• consumption-historyConsumption Historyread-only

  Search your consumption history — wines you've opened and drunk. Filter by wine name, color, or date range. Returns most recent consumptions first with tasting context, up to max_results per page (default 25) — pass offset to page through more.

• drinking-recommendationsDrinking Recommendationsread-only

  Get wine drinking recommendations sorted by urgency. Orders wines by their listed drinking window: past the window first, then in the final year, then the rest of the window (earliest end first), then not yet open. Status describes the listed window only; CellarTracker's drinkability index (a bottle-count pacing number, not a maturity measure) is reported separately and only breaks ties. Optionally filter by color.

• get-wishlistView Wishlistread-only

  View your CellarTracker wishlist wines. Optionally search by wine name, region, or varietal.

• incoming-ordersIncoming Ordersread-only

  List wines ordered but not yet received, from the Pending table. Sorted oldest order first. Use this for 'what's on the way', unlike recent-deliveries which shows what has already arrived.

• purchase-historyPurchase Historyread-only

  Search purchase history with spending summary. Filter by wine name, store, or date range (YYYY-MM-DD format). Shows total spent, average price, per-store breakdown, and recent purchases.

• recent-deliveriesRecent Deliveriesread-only

  List wines actually delivered (received) in a date range, keyed on DeliveryDate. Defaults to the last 30 days. Use this for 'what just landed', unlike purchase-history which keys on order date.

• refresh-dataRefresh Cellar Dataread-only

  Force refresh all CellarTracker data from the server. Downloads fresh CSV exports for all 8 tables regardless of cache age.

• search-cellarSearch Cellarread-only

  Search your wine cellar by name, color, region, varietal, location, or vintage range. The region parameter searches across Country, Region, SubRegion, Appellation, and Locale fields. Returns matching wines with details, up to 25 per page — pass offset to page through more.

• setup-credentialsSet Up Credentials

  Set up or update your CellarTracker login credentials. Validates credentials against CellarTracker before saving. Use this if you just installed the plugin or need to change your login.

• tasting-notesTasting Notesread-only

  Search your tasting notes and reviews. Filter by wine name, color, or minimum rating. Returns notes with ratings, scores, and tasting details, up to max_results per page (default 25) — pass offset to page through more.

Signals

Stars

7

Forks

2

Open issues

6

Last commit

Oct 13, 2026 (17 days ago)

Last release

Oct 13, 2026 (18 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.slavins-co/cellartracker-mcp

Version

0.5.4

Auth

API key

Packages

npm cellartracker-mcp

License

MIT

Repository

github.com/slavins-co/cellartracker-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql