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
| 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 a bottle |
add_bottles_batch | Add up to 100 bottles at once |
update_bottle | Change status, notes, location, price, vintage |
delete_bottle | Remove a bottle |
recommend_bottles | Recommendation for a meal or based on maturity |
scan_label | Identify a wine from a label photo |
scan_labels_batch | Up 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
- "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?"
- "Mark the last bottle of Cahors as consumed"
- "Scan this label: [photo]"
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
- npm package: @emile-wine/mcp-server
- MCP spec: modelcontextprotocol.io
- Questions: hello@emile.wine