# Cellarion

Connects your AI assistant to a Cellarion account to browse bottles, check rack locations, and track drinking windows.

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

## What it does

This bridge translates stdio MCP client calls to the Cellarion `/api/mcp` endpoint using a personal API credential. Tool schemas and available resources originate directly from the host application. Because the remote instance dictates the tool definitions, new features appear in the assistant without modifying the local runner.

Operation requires an existing account token minted with the `read` permission scope. Without `CELLARION_TOKEN`, the process terminates. By default, queries route to `https://cellarion.app`, while self-hosted instances can be targeted by supplying `CELLARION_URL` in the environment settings.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://cellarion.app/api/mcp`
- Environment variables: `CELLARION_TOKEN`, `CELLARION_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http cellarion https://cellarion.app/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env CELLARION_TOKEN=<CELLARION_TOKEN> --env CELLARION_URL=<CELLARION_URL> --transport stdio cellarion-mcp -- npx -y cellarion-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cellarion-mcp --url https://cellarion.app/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add cellarion-mcp --env CELLARION_TOKEN=<CELLARION_TOKEN> --env CELLARION_URL=<CELLARION_URL> -- npx -y cellarion-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cellarion-mcp": {
            "url": "https://cellarion.app/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cellarion-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cellarion-mcp"
            ],
            "env": {
                "CELLARION_TOKEN": "<CELLARION_TOKEN>",
                "CELLARION_URL": "<CELLARION_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cellarion-mcp": {
            "type": "http",
            "url": "https://cellarion.app/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cellarion-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cellarion-mcp"
            ],
            "env": {
                "CELLARION_TOKEN": "<CELLARION_TOKEN>",
                "CELLARION_URL": "<CELLARION_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cellarion-mcp https://cellarion.app/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e CELLARION_TOKEN=<CELLARION_TOKEN> -e CELLARION_URL=<CELLARION_URL> cellarion-mcp npx -y cellarion-mcp
```
Replace <…> with your own values

## When to use it
- locate specific wine varieties across home cellar racks
- identify bottles nearing the end of their drinking window
- review past tastings and personal scores from your log

## Example prompts
- Check which bottles in my collection should be opened this week before they decline
- Do I have any bottles of Barolo left, and which rack are they in?
- Show what wines I logged last month alongside my ratings

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

From the same set: [jagduvi1/cellarion](https://affpapa.org/en/nevibecode/by/jagduvi1/cellarion.md) — 2 cards

---
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