wg-easy MCP Server

Name: wg-easy MCP Server
Author: io.github.ni-c

io.github.ni-c/wg-easy-mcp

Repository Registry

What is the wg-easy MCP server?

Administer wg-easy (WireGuard Easy) v15: manage VPN clients, configs, QR codes and server status

How to install wg-easy

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

WG_EASY_URL
required
Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821
WG_EASY_USERNAME
required
Username of a wg-easy admin account (2FA must be disabled)
WG_EASY_PASSWORD
required
secret
Password of the wg-easy admin account
WG_EASY_INSECURE_TLS
Set to true to accept self-signed TLS certificates (scoped to the wg-easy connection)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wg-easy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wg-easy-mcp"
      ],
      "env": {
        "WG_EASY_URL": "<YOUR_WG_EASY_URL>",
        "WG_EASY_USERNAME": "<YOUR_WG_EASY_USERNAME>",
        "WG_EASY_PASSWORD": "<YOUR_WG_EASY_PASSWORD>",
        "WG_EASY_INSECURE_TLS": "<YOUR_WG_EASY_INSECURE_TLS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "wg-easy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wg-easy-mcp"
      ],
      "env": {
        "WG_EASY_URL": "<YOUR_WG_EASY_URL>",
        "WG_EASY_USERNAME": "<YOUR_WG_EASY_USERNAME>",
        "WG_EASY_PASSWORD": "<YOUR_WG_EASY_PASSWORD>",
        "WG_EASY_INSECURE_TLS": "<YOUR_WG_EASY_INSECURE_TLS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wg-easy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wg-easy-mcp"
      ],
      "env": {
        "WG_EASY_URL": "<YOUR_WG_EASY_URL>",
        "WG_EASY_USERNAME": "<YOUR_WG_EASY_USERNAME>",
        "WG_EASY_PASSWORD": "<YOUR_WG_EASY_PASSWORD>",
        "WG_EASY_INSECURE_TLS": "<YOUR_WG_EASY_INSECURE_TLS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "wg-easy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wg-easy-mcp"
      ],
      "env": {
        "WG_EASY_URL": "<YOUR_WG_EASY_URL>",
        "WG_EASY_USERNAME": "<YOUR_WG_EASY_USERNAME>",
        "WG_EASY_PASSWORD": "<YOUR_WG_EASY_PASSWORD>",
        "WG_EASY_INSECURE_TLS": "<YOUR_WG_EASY_INSECURE_TLS>"
      }
    }
  }
}

Claude Code

claude mcp add wg-easy-mcp --env WG_EASY_URL=<YOUR_WG_EASY_URL> --env WG_EASY_USERNAME=<YOUR_WG_EASY_USERNAME> --env WG_EASY_PASSWORD=<YOUR_WG_EASY_PASSWORD> --env WG_EASY_INSECURE_TLS=<YOUR_WG_EASY_INSECURE_TLS> -- npx -y wg-easy-mcp