Skip to content
MCP server

Wakeonlan MCP Server

Wake LAN machines with Wake-on-LAN magic packets from host profiles, then confirm they…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.2.0
Listing updated
4 days ago

About Wakeonlan MCP Server

Wakeonlan MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Wake LAN machines with Wake-on-LAN magic packets from host profiles, then confirm they came up.

Install

Run in a terminal

claude mcp add wakeonlan-mcp-server --env WOL_HOSTS='<WOL_HOSTS>' -- npx -y @cyanheads/wakeonlan-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wakeonlan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/wakeonlan-mcp-server"
      ],
      "env": {
        "WOL_HOSTS": "<WOL_HOSTS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wakeonlan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/wakeonlan-mcp-server"
      ],
      "env": {
        "WOL_HOSTS": "<WOL_HOSTS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "wakeonlan-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/wakeonlan-mcp-server"
      ],
      "env": {
        "WOL_HOSTS": "<WOL_HOSTS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "wakeonlan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/wakeonlan-mcp-server"
      ],
      "env": {
        "WOL_HOSTS": "<WOL_HOSTS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "wakeonlan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/wakeonlan-mcp-server"
      ],
      "env": {
        "WOL_HOSTS": "<WOL_HOSTS>"
      }
    }
  }
}

Configuration

  • WOL_HOSTS_FILEAbsolute path to the JSON hosts file (a leading ~/ expands to the home directory). Mutually exclusive with WOL_HOSTS.
  • WOL_HOSTSThe hosts document as inline JSON, for single-host setups. Mutually exclusive with WOL_HOSTS_FILE.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'. The server refuses to start without jwt or oauth when MCP_HTTP_HOST is not a loopback address or MCP_ALLOWED_ORIGINS is '*'.
  • WOL_HOSTS_FILEAbsolute path to the JSON hosts file (a leading ~/ expands to the home directory). Mutually exclusive with WOL_HOSTS.
  • WOL_HOSTSThe hosts document as inline JSON, for single-host setups. Mutually exclusive with WOL_HOSTS_FILE.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Wakeonlan MCP Server FAQ

Is Wakeonlan MCP Server free?

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

How do I add Wakeonlan MCP Server to Claude Code?

Run this command in your terminal: claude mcp add wakeonlan-mcp-server --env WOL_HOSTS='<WOL_HOSTS>' -- npx -y @cyanheads/wakeonlan-mcp-server