@emile-wine/mcp-server

Émile is your French wine cellar app. This MCP server lets you query and manage your cellar from Claude Desktop, Cursor, or any Model Context Protocol client.

What it does

10 tools to talk to your Émile cellar:

| Tool | Description | |---|---| | search_wines | Search the catalog by name/producer/appellation | | list_cellars | List your cellars | | list_bottles | List bottles in a cellar | | add_bottle | Add 1 bottle | | add_bottles_batch | Add up to 100 bottles in one call | | update_bottle | Change status, notes, location, price, vintage, quantity | | delete_bottle | Remove a bottle (prefer update_bottle status=drunk for history) | | recommend_bottles | Get bottle recommendations for a meal or maturity | | scan_label | Identify a wine from a label photo (base64) | | scan_labels_batch | Up to 10 label photos in one call |

Quick start (Claude Desktop)

1. Get an API key

Open the Émile iOS app → Profile → Settings → API Keys → tap + Generate. Copy the emile_live_... value (shown only once).

2. Edit your Claude Desktop config

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "emile": {
      "command": "npx",
      "args": ["-y", "@emile-wine/mcp-server"],
      "env": {
        "EMILE_API_KEY": "emile_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Restart Claude Desktop

You should see the 🔌 indicator in the bottom of the input box, with emile listed.

4. Try it

"Show me my main cellar" "Recommend a bottle for tonight's pasta with mushrooms" "Add a 2018 Pomerol to Cave A"

Configuration

| Env var | Required | Default | Description | |---|---|---|---| | EMILE_API_KEY | yes | — | API key from the iOS app | | EMILE_API_URL | no | https://api.emile.wine | Override for local dev (http://localhost:8000 allowed) | | EMILE_LOG_LEVEL | no | info | One of debug, info, warn, error |

Troubleshooting

"Émile API key is invalid or revoked" — Generate a new key in the iOS app. Old keys are revoked when you delete them or when global key rotation happens (rare).

"Cannot reach Émile API" — Check your internet connection. The default endpoint https://api.emile.wine should be reachable; you can verify with:

curl https://api.emile.wine/health

"Rate limit exceeded" — The MCP server inherits the API's rate limits (varies by endpoint, typically 10-60 req/min). Wait the suggested retry seconds.

Need to debug a tool call — set EMILE_LOG_LEVEL=debug in the config and check Claude Desktop's MCP logs at ~/Library/Logs/Claude/mcp*.log.

Privacy

This MCP server is stateless and doesn't persist anything. Your API key is read from env at startup. All requests go directly to https://api.emile.wine (or your override). Photo data sent to scan_label is processed transient by the backend (not stored). See https://api.emile.wine/privacy for the full policy.

Other MCP clients

The same npx -y @emile-wine/mcp-server invocation works in any client supporting stdio MCP servers:

• Cursor — ~/.cursor/mcp.json
• Continue — ~/.continue/config.json experimental.modelContextProtocolServer
• Custom clients — connect to stdout/stdin, speak MCP

License

MIT — see LICENSE.