# Cellarion

> Cellarion is an open-source MCP server for food and drink. Local stdio bridge that lets Claude Desktop or Cursor query your Cellarion wine cellar. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://cellarion.app
- **Repository:** https://github.com/jagduvi1/cellarion/tree/HEAD/cellarion-mcp
- **MCP Registry name:** app.cellarion/cellarion
- **Categories:** food and drink
- **Listing updated:** 2026-11-14

## About

Ask whether you still have any Barolo and where the bottles sit, what to open tonight before it passes its peak, or what you drank last month and how you rated it. This npm package runs on your own machine and proxies to the /api/mcp endpoint of a Cellarion server.

It authenticates with a personal token that starts with cel_, created under Settings, API tokens with the read scope, so it can read your own cellar but not change anything, see other accounts or manage tokens. Point it at a self-hosted instance by setting CELLARION_URL.

Tool and resource definitions come from the server, so updating Cellarion updates what the AI can do. If the connection drops, the bridge reconnects and retries read-only calls; calls that might change data are only resent when they carry an idempotency key.

## Features

- **Read-only token:** A revocable token with read scope limits access to your own cellar.
- **Stdio bridge:** Runs locally through npx for Claude Desktop, Cursor and similar clients.
- **Self-host support:** Set CELLARION_URL to use your own instance.
- **Safe retries:** Reconnects and resends only read-only or idempotent calls.

## Good for

- Pick a bottle nearing the end of its drink window
- Find where a wine is stored in the racks
- Review recent drinking history and ratings

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http cellarion https://cellarion.app/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cellarion.app/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cellarion": {
      "url": "https://cellarion.app/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cellarion": {
      "type": "http",
      "url": "https://cellarion.app/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cellarion": {
      "serverUrl": "https://cellarion.app/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cellarion": {
      "type": "http",
      "url": "https://cellarion.app/api/mcp"
    }
  }
}
```

## FAQ

### How do I get a token?

Create one in Cellarion under Settings, API tokens, with the read scope; it is shown once.

### Can it change my cellar?

A read-scope token cannot modify anything.

### What licence applies?

AGPL-3.0, like Cellarion itself.

### Is there a remote option?

The registry also lists a streamable HTTP endpoint at cellarion.app/api/mcp.

### Is Cellarion free?

Yes. Cellarion is open source, so you can use and self-host it for free.

### How do I add Cellarion to Claude Code?

Run this command in your terminal: claude mcp add --transport http cellarion https://cellarion.app/api/mcp

### What are the best alternatives to Cellarion?

The closest alternatives to Cellarion are Fast Food Index, Cook with Loopware, O Meu Financeiro, Cellarion Wine Registry and MyGroceryPal.

## Alternatives

- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.
- [Cook with Loopware](https://ai-powered.com/mcp/cook-with-loopware): Cook with Loopware is a free MCP server for food and drink.
- [O Meu Financeiro](https://ai-powered.com/mcp/o-meu-financeiro): O Meu Financeiro is an MCP server for finance and payments.
- [Cellarion Wine Registry](https://ai-powered.com/mcp/cellarion-wine-registry): Cellarion Wine Registry is a free MCP server for food and drink.
- [MyGroceryPal](https://ai-powered.com/mcp/mygrocerypal): MyGroceryPal is a free MCP server for e-commerce.
- [Dishes of London](https://ai-powered.com/mcp/dishes-of-london): Dishes of London is a free MCP server for food and drink.
- [ChefSums](https://ai-powered.com/mcp/chefsums): ChefSums is a freemium MCP server for food and drink.
- [The Meal Plan Vault](https://ai-powered.com/mcp/the-meal-plan-vault): The Meal Plan Vault is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/cellarion
