Use Émile from your AI assistant

Émile ships an official MCP server. In 2 minutes you can ask Claude, Cursor or any MCP-compatible client to add, scan or recommend bottles straight from your cellar.

Prerequisites: the Émile iOS app installed with an account. The MCP server uses a personal API key to talk to the backend.

What you can do

ToolDescription
search_winesSearch the catalog by name, producer, appellation
list_cellarsList your cellars
list_bottlesList bottles in a cellar
add_bottleAdd a bottle
add_bottles_batchAdd up to 100 bottles at once
update_bottleChange status, notes, location, price, vintage
delete_bottleRemove a bottle
recommend_bottlesRecommendation for a meal or based on maturity
scan_labelIdentify a wine from a label photo
scan_labels_batchUp to 10 label photos at once

Setup — Claude Desktop

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 Claude Desktop config

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "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 at the bottom of the input box, with emile in the list.

Prompt examples

Cursor, Cline, other MCP clients

The server works with any MCP-compatible client. The config is the same: command npx -y @emile-wine/mcp-server + env var EMILE_API_KEY. Adapt the syntax to your client's config format.

Privacy

Your API key stays on your machine. The MCP 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.

Sources & support