Voila Groceries MCP Server

by dearlordylordio.github.dearlordylord/voila-mcpv0.3.0

Personal Voila grocery automation: search products, check discounts, list delivery slots, read cart and order history and update cart quantities.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained46d ago

Install Voila Groceries MCP server

claude mcp add voila -e VOILA_AUTH_SESSION_PATH='<voila-auth-session-path>' -- npx -y @firfi/voila-mcp

{
  "mcpServers": {
    "voila": {
      "command": "npx",
      "args": [
        "-y",
        "@firfi/voila-mcp"
      ],
      "env": {
        "VOILA_AUTH_SESSION_PATH": "<voila-auth-session-path>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "voila": {
      "command": "npx",
      "args": [
        "-y",
        "@firfi/voila-mcp"
      ],
      "env": {
        "VOILA_AUTH_SESSION_PATH": "<voila-auth-session-path>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "voila": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@firfi/voila-mcp"
      ],
      "env": {
        "VOILA_AUTH_SESSION_PATH": "<voila-auth-session-path>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "voila": {
      "command": "npx",
      "args": [
        "-y",
        "@firfi/voila-mcp"
      ],
      "env": {
        "VOILA_AUTH_SESSION_PATH": "<voila-auth-session-path>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
VOILA_GUEST	—	—	Set to 1 for guest-session behavior in registry inspection or unauthenticated discovery.
VOILA_AUTH_SESSION_PATH	—	yes	Absolute path to a session JSON file captured with the Voila CLI for authenticated account workflows. Read and written as one path; guest sessions are never written to it.

Freshness

Maintained — last maintenance signal 46d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-24 · 46d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-20 · 51d ago · official registry · v0.3.0

FAQ

›How do I install the Voila Groceries MCP server in Claude Code?

Run: claude mcp add voila -e VOILA_AUTH_SESSION_PATH='<voila-auth-session-path>' -- npx -y @firfi/voila-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Voila Groceries require an API key?

Yes. It expects VOILA_AUTH_SESSION_PATH, of which 1 is a secret.

›Can I use Voila Groceries as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Voila Groceries in the official MCP registry?

Yes, as io.github.dearlordylord/voila-mcp.