wg-easy MCP Server: Install & Setup

Install wg-easy in Claude Code

npm

Claude Code

claude mcp add wg-easy -e WG_EASY_URL=... -e WG_EASY_USERNAME=... -e WG_EASY_PASSWORD=... -- npx -y wg-easy-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "wg-easy": {
      "command": "npx",
      "args": [
        "-y",
        "wg-easy-mcp"
      ],
      "env": {
        "WG_EASY_URL": "...",
        "WG_EASY_USERNAME": "...",
        "WG_EASY_PASSWORD": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add wg-easy -e WG_EASY_URL=... -e WG_EASY_USERNAME=... -e WG_EASY_PASSWORD=... -- docker run -i --rm -e WG_EASY_URL -e WG_EASY_USERNAME -e WG_EASY_PASSWORD ghcr.io/ni-c/wg-easy-mcp:0.6.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "wg-easy": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WG_EASY_URL",
        "-e",
        "WG_EASY_USERNAME",
        "-e",
        "WG_EASY_PASSWORD",
        "ghcr.io/ni-c/wg-easy-mcp:0.6.0"
      ],
      "env": {
        "WG_EASY_URL": "...",
        "WG_EASY_USERNAME": "...",
        "WG_EASY_PASSWORD": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the wg-easy MCP server do?

Administer a self-hosted wg-easy (WireGuard Easy) instance: manage VPN clients, fetch configs and QR codes, create one-time links and check server status.

Is the wg-easy MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does wg-easy run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add wg-easy to Claude Code?

Run: claude mcp add wg-easy -e WG_EASY_URL=... -e WG_EASY_USERNAME=... -e WG_EASY_PASSWORD=... -- npx -y wg-easy-mcp

More cloud platforms MCP servers

View all

Cloud Regions

0218

jasonwilbur/mcp-server-cloud-regions

Cloud region data for AWS, Azure, GCP, OCI & more. Query by location, compliance, GPU.

LocalFree

Oriel

ParadoxInfinite/oriel

Safety-gated AI control of Docker and Colima: containers, images, volumes, networks, Compose.

LocalFree

JAJ Dataverse Dev

0216

jjohnsen/jaj-dataverse-dev-mcp

Xrm/Power Platform/Dataverse MCP for devs, Azure CLI auth, Web API and multi-environment support

LocalFree

Package Version Check

MShekow/package-version-check-mcp

Returns the latest package / dependency / tool versions for Python, NPM, Go, Docker, Helm, etc.

LocalFree

Minerva

1184

HoussemMak/minerva-mcp

Microsoft 365 & Azure admin: Graph, ARM, and the PowerShell cmdlets Graph does not expose.

LocalFree

Hetzner DNS

0255

ni-c/hetzner-dns-mcp

Manage Hetzner DNS zones and records via the Hetzner Cloud API: RRSet CRUD, zonefile import/export, TTL and protection changes, and nameservers.

LocalAccount neededTypeScript