Wake LAN machines with Wake-on-LAN magic packets from host profiles, then confirm they came up.
Connect Runs on your machine
claude mcp add wakeonlan-mcp-server -e WOL_HOSTS_FILE=<WOL_HOSTS_FILE> -e WOL_HOSTS=<WOL_HOSTS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/[email protected]{
"mcpServers": {
"wakeonlan-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"WOL_HOSTS_FILE": "<WOL_HOSTS_FILE>",
"WOL_HOSTS": "<WOL_HOSTS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"mcpServers": {
"wakeonlan-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"WOL_HOSTS_FILE": "<WOL_HOSTS_FILE>",
"WOL_HOSTS": "<WOL_HOSTS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"servers": {
"wakeonlan-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"WOL_HOSTS_FILE": "<WOL_HOSTS_FILE>",
"WOL_HOSTS": "<WOL_HOSTS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WOL_HOSTS_FILEOptional | Absolute path to the JSON hosts file (a leading ~/ expands to the home directory). Mutually exclusive with WOL_HOSTS. |
WOL_HOSTSOptional, secret | The hosts document as inline JSON, for single-host setups. Mutually exclusive with WOL_HOSTS_FILE. |
MCP_LOG_LEVELOptional | Sets the minimum log level for output (e.g., 'debug', 'info', 'warn'). |
Details
| Package | @cyanheads/[email protected] (NPM, stdio) |
| Package | @cyanheads/[email protected] (NPM, streamable-http) |
| First published | 29 Oct 2026 |
| Last updated | 29 Oct 2026 |
| Registry name | io.github.cyanheads/wakeonlan-mcp-server |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.