Skip to content
MCP server

Cellarion

Local stdio bridge that lets Claude Desktop or Cursor query your Cellarion wine cellar

Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally or Remotely
Version
1.301.0
Listing updated
3 days ago

About Cellarion

Cellarion is an open-source MCP server for food and drink. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://cellarion.app/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cellarion": {
      "url": "https://cellarion.app/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CELLARION_TOKENPersonal API token from Settings -> API tokens (starts with cel_).Required
  • CELLARION_URLBase URL of your Cellarion server. Leave unset for the hosted app.

What it does

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

Pricing

Open source

Cellarion's own site says every feature is free

Prices change. Check cellarion.app before you buy.

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

  1. Fast Food Index

    MCP server

    Live US fast food menu prices, Big Mac index by state and verified price changes

    • 6 tools
    • Remote
    • Free
    • Food and drink
  2. Calculated recipes for your cookware, guided step by step by your voice assistant

    Not checked yet
    • Remote
    • Free
    • Food and drink
  3. Ask about a Brazilian restaurant's sales, bills, balances and DRE, and log expenses

    Not checked yet
    • Remote
    • Free trial
    • Finance and payments
  4. Public MCP endpoint for searching wines, grapes, regions and appellations, no account

    • 6 tools
    • Remote
    • Free
    • Food and drink
  5. MyGroceryPal

    MCP server

    Compare UK supermarket prices for items, baskets and lists from ChatGPT or Claude

    • 11 tools
    • Remote
    • Free
    • E-commerce
  6. Find a dish in London by area, postcode, price, diet and serving time

    • 5 tools
    • Remote
    • Free
    • Food and drink