# CellarTracker

Hooks your CellarTracker account into an AI agent so it can read inventory, drinking windows, purchases and tasting notes on request.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: slavins-co
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/slavins-co/cellartracker-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/cellartracker

## What it does

CellarTracker MCP reaches your wine cellar through CellarTracker's CSV export, since the service ships no official API. Results are cached on your machine and pulled again every 24 hours; `refresh-data` forces a fresh pull when you need one. Only your own account is visible — the server cannot search CellarTracker's public wine database.

Thirteen tools come with it. `search-cellar` filters by name, colour, region, varietal or vintage, `drinking-recommendations` ranks bottles by how urgent their drinking window is, and `purchase-history` plus `consumption-history` break down spending and opened bottles. For bulk work the server exposes cached table exports as MCP resources at `cellartracker://tables/`, which sidesteps the 25-per-page cap on list tools. The Claude plugin adds two skills: `cellartracker-data` explains table relationships and score abbreviations, while `wine-purchase-evaluator` scores a purchase on Quality and Personal Fit and returns BUY, CONSIDER or PASS.

Login happens with your real username and password, passed as URL query parameters over HTTPS. CellarTracker offers no OAuth and no scoped tokens, so the server authenticates with full account rights even though every operation it performs is read-only. Skip `CT_USERNAME` and `CT_PASSWORD` and the tools return errors while the skills sit idle — run `setup-credentials` first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CT_USERNAME`, `CT_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CT_USERNAME=<CT_USERNAME> --env CT_PASSWORD=<CT_PASSWORD> --transport stdio cellartracker -- npx -y cellartracker-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cellartracker --env CT_USERNAME=<CT_USERNAME> --env CT_PASSWORD=<CT_PASSWORD> -- npx -y cellartracker-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cellartracker": {
            "command": "npx",
            "args": [
                "-y",
                "cellartracker-mcp"
            ],
            "env": {
                "CT_USERNAME": "<CT_USERNAME>",
                "CT_PASSWORD": "<CT_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cellartracker": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cellartracker-mcp"
            ],
            "env": {
                "CT_USERNAME": "<CT_USERNAME>",
                "CT_PASSWORD": "<CT_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CT_USERNAME=<CT_USERNAME> -e CT_PASSWORD=<CT_PASSWORD> cellartracker npx -y cellartracker-mcp
```
Replace <…> with your own values

## When to use it
- see which bottles are ready to open this month
- total wine spending by store over a date range
- check whether a new purchase duplicates something already in the cellar
- locate a bottle by bin, size or barcode
- pull up your own tasting notes and scores for a wine

## Example prompts
- Which wines should I open this month?
- Show my wine spending by store over the last year
- Is this bottle worth the price — check my cellar for duplicates

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md