Use Émile from your AI assistant

Émile ships an official MCP server. Ask Claude, ChatGPT, Cursor or any MCP-compatible client to add, scan or recommend bottles straight from your cellar. Two connection modes: remote OAuth (simplest, recommended) or local npx (for clients without OAuth support).

Prerequisites: an Émile account (sign up via the iOS app or at app.emile.wine).

What you can do

Tool	Description
search_wines	Search the 100k+ catalog by name, producer, appellation
list_cellars	List your cellars
list_bottles	List bottles in a cellar
add_bottle	Add a bottle
add_bottles_batch	Add up to 100 bottles at once
update_bottle	Change status, notes, location, price, vintage, or move between cellars
delete_bottle	Remove a bottle
recommend_bottles	Pairing recommendation for a meal or based on drinking maturity
scan_label	Identify a wine from a label photo
scan_labels_batch	Up to 10 label photos at once

Option 1 — Remote connection (OAuth)

The simplest path: Claude Desktop, ChatGPT and other recent clients support adding a remote MCP server via OAuth — no local config file, no API key to manage.

Claude Desktop

1. Settings → Connectors → Add custom connector
2. URL: https://mcp.emile.wine/mcp
3. Click Connect → you'll be redirected to app.emile.wine to sign in and authorize
4. Back in Claude, the connector is active. Try: "List my cellars"

ChatGPT (Developer Mode)

1. Settings → Connectors → enable Developer Mode
2. Create app → URL: https://mcp.emile.wine/mcp
3. Authentication: OAuth (auto-detected)
4. Complete the authorization flow (Émile sign-in) then test

Option 2 — Local install (npx)

For clients that don't yet support remote OAuth (Cursor, Continue, Cline…), the server runs locally via npm and talks directly to api.emile.wine using a personal API key.

1. Generate an API key from the app

Open Émile on your iPhone → Profile → Settings → API Keys → + Generate. Copy the emile_live_... key (shown only once).

2. Add the server to your config

Example for Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

For Cursor / Continue / others: same command npx -y @emile-wine/mcp-server + the EMILE_API_KEY env variable, adapt the syntax to your client's config format.

3. Restart your client

The MCP indicator should appear with emile listed in the connected servers.

Prompt examples

• "List the bottles in my main cellar"
• "Add a Château Pichon Lalande 2015, bought €95, slot A3"
• "What should we drink tonight with duck breast?"
• "Move the Chinon bottle from my garage cellar to the kitchen cellar"
• "Mark the last bottle of Cahors as consumed"
• "Scan this label: [photo]"

Privacy

Remote OAuth mode: no credential storage on the client side, authorization is revocable from your Émile account at any time. The server runs on our infrastructure in France behind a strict CSP, and every request is validated through a short-lived token.

Local npx mode: your API key stays on your machine. The server runs locally and talks directly to api.emile.wine. No third party in between — it's exactly like using the app, but via text.

In both cases, see the full privacy policy.

Also available on

• 📱 iOS App Store — the native Émile app
• 🌐 app.emile.wine — web signup + API key management
• 📦 npm @emile-wine/mcp-server
• 📋 Official MCP Registry — listed as io.github.SebastienGal/emile-wine

Sources & support

• MCP spec: modelcontextprotocol.io
• Questions, feedback, bugs: [email protected]