proxmox-execute-vm-command
Execute commands inside a running Proxmox VM using the QEMU guest agent. Specify VM ID and command string; note that pipes and redirects are not supported.
Instructions
Execute a command inside a running VM via QEMU guest agent. The VM must have the QEMU guest agent installed and running. Pass command as a single string (e.g., 'apt-get update' or 'uname -a'). The tool parses it into an array per the guest agent API. Shell features like pipes (|) and redirects (2>&1) are NOT supported. Uses the Proxmox API (PROXMOX_URL, PROXMOX_API_TOKEN) for communication.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vmid": "<vmid>",
"command": "<command>"
},
"name": "proxmox-execute-vm-command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Proxmox node name (e.g. 'pve', 'pve1') | pve |
| vmid | Yes | VM ID (e.g. 100, 101) | |
| command | Yes | Command to run inside the VM via QEMU guest agent. The command string is parsed into an array per the guest agent API (e.g., 'uname -a' becomes ['uname', '-a']). Note: shell features like pipes (|) and redirects (2>&1) are NOT supported — pass a single executable with arguments only. | |
| timeoutMs | No | Maximum time to wait for command completion in milliseconds (default: 30000) |