Skip to content
MCP server

Gaggiuino MCP

Remote MCP server for your Gaggiuino espresso machine's shots and profiles

Install
Pricing
Open source
Runs
Remotely
Version
6.0.0
Listing updated
5 days ago

About Gaggiuino MCP

Gaggiuino MCP is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add gaggiuino-mcp --env MCP_OAUTH_SECRET='<MCP_OAUTH_SECRET>' --env MCP_OAUTH_PASSPHRASE_HASH='<MCP_OAUTH_PASSPHRASE_HASH>' -- docker run -i --rm -e MCP_OAUTH_SECRET -e MCP_OAUTH_PASSPHRASE_HASH ghcr.io/ljcl/gaggiuino-mcp:6.0.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gaggiuino-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_OAUTH_SECRET",
        "-e",
        "MCP_OAUTH_PASSPHRASE_HASH",
        "ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
      ],
      "env": {
        "MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gaggiuino-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_OAUTH_SECRET",
        "-e",
        "MCP_OAUTH_PASSPHRASE_HASH",
        "ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
      ],
      "env": {
        "MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gaggiuino-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_OAUTH_SECRET",
        "-e",
        "MCP_OAUTH_PASSPHRASE_HASH",
        "ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
      ],
      "env": {
        "MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "gaggiuino-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_OAUTH_SECRET",
        "-e",
        "MCP_OAUTH_PASSPHRASE_HASH",
        "ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
      ],
      "env": {
        "MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gaggiuino-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_OAUTH_SECRET",
        "-e",
        "MCP_OAUTH_PASSPHRASE_HASH",
        "ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
      ],
      "env": {
        "MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GAGGIUINO_URLGaggiuino machine URL (default http://gaggiuino.local)
  • PORTServer port (default 8000)
  • HOSTBind address (default 0.0.0.0)
  • MCP_PUBLIC_URLPublic https origin clients reach this server on, with no path (e.g. https://box.tailnet.ts.net). Set with MCP_OAUTH_SECRET to enable OAuth; it is advertised as the OAuth resource and must match the URL entered in the client exactly
  • MCP_OAUTH_SECRETSigning key for self-issued OAuth access and refresh tokens, at least 32 characters (openssl rand -hex 32). Keep it stable across restarts so clients stay signed in
  • MCP_OAUTH_PASSPHRASE_HASHscrypt hash of the passphrase you type on the OAuth consent page, in the form scrypt$N$r$p$salt$hash. Required whenever OAuth is enabled. Generate with `bun run hash-passphrase` — never store the passphrase itself
  • MCP_OAUTH_ISSUERExternal OAuth issuer URL to delegate token issuing to (e.g. a Keycloak or Authentik realm). Puts the server in resource-server-only mode; requires MCP_PUBLIC_URL and refuses to start alongside MCP_OAUTH_SECRET or MCP_OAUTH_PASSPHRASE_HASH
  • MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call /mcp, or * to allow any (unsafe). Requests with no Origin header are unaffected
  • MCP_ALLOWED_HOSTSComma-separated Host header values to accept on /mcp. Empty disables host validation
  • LOG_LEVELLog verbosity: debug, info, warn, error, or silent (default info). Logs are one JSON object per line on stderr

Pricing

Open source

Gaggiuino MCP FAQ

Is Gaggiuino MCP free?

Yes. Gaggiuino MCP is open source, so you can use and self-host it for free.

How do I add Gaggiuino MCP to Claude Code?

Run this command in your terminal: claude mcp add gaggiuino-mcp --env MCP_OAUTH_SECRET='<MCP_OAUTH_SECRET>' --env MCP_OAUTH_PASSPHRASE_HASH='<MCP_OAUTH_PASSPHRASE_HASH>' -- docker run -i --rm -e MCP_OAUTH_SECRET -e MCP_OAUTH_PASSPHRASE_HASH ghcr.io/ljcl/gaggiuino-mcp:6.0.0

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers