Skill: jgm2025/veeam-mcp (version 1.0.3)

--- name: veeam-mcp description: "Query Veeam Backup & Replication and Veeam ONE via MCP server running in Docker. Provides intelligent backup monitoring, job analysis, capacity planning, and infrastructure health checks." --- # Veeam Intelligence MCP Skill Interact with Veeam Backup & Replication (VBR) and Veeam ONE through an MCP (Model Context Protocol) server running in Docker. ## Natural Language Commands When the user asks things like: - **"What backup jobs failed last night?"** - **"Show me backup status for all VMs"** - **"What's my backup repository capacity?"** - **"Which VMs haven't been backed up recently?"** - **"Check Veeam ONE alerts"** - **"Analyze backup performance trends"** ## What This Does This skill wraps the Veeam Intelligence MCP server (running in Docker) and provides natural language access to: **Veeam Backup & Replication (VBR):** - Backup job status and history - Repository capacity and health - VM backup status - Job configuration details - Failed job analysis **Veeam ONE:** - Infrastructure monitoring - Performance analysis - Alert management - Capacity planning - Trend analysis ## Prerequisites - Docker installed and running - Veeam Backup & Replication and/or Veeam ONE with active licenses (not Community Edition) - **Veeam Intelligence enabled** on your Veeam servers (required for Advanced Mode) - Admin credentials for Veeam servers ## Installation ### 1. Obtain Veeam Intelligence MCP Server The Veeam Intelligence MCP server is currently in **beta**. **To obtain access:** - Contact Veeam directly or your Veeam account representative - Visit the official Veeam community forums - Check Veeam's official channels for beta program announcements Once you have the MCP server package, build the Docker image: ```bash cd /path/to/veeam-mcp-server docker build -t veeam-intelligence-mcp-server . ``` ### 2. Install This Skill ```bash clawhub install veeam-mcp ``` ## Configuration ### Create Credentials File Create `~/.veeam-mcp-creds.json`: ```json { "vbr": { "url": "https://veeam-server.yourdomain.com:443/", "username": ".\\administrator", "password": "your_secure_password" }, "vone": { "url": "https://veeam-one.yourdomain.com:1239/", "username": ".\\administrator", "password": "your_secure_password" } } ``` **Important:** Lock down the credentials file: ```bash chmod 600 ~/.veeam-mcp-creds.json ``` ### Username Format - **Local accounts**: Use `".\\username"` format - **Domain accounts**: Use `"DOMAIN\\username"` or `"[REDACTED_SECRET]"` - **Escape backslashes**: Single backslash in JSON: `".\\"` not `".\\\\"` ### Enable Veeam Intelligence For live data queries (Advanced Mode), enable Veeam Intelligence on your Veeam servers: **Veeam Backup & Replication:** 1. Open Veeam B&R console 2. Go to **Options** → **Veeam Intelligence Settings** 3. Enable the AI assistant **Veeam ONE:** 1. Open Veeam ONE console 2. Find **Veeam Intelligence** settings 3. Enable the feature Without this, queries will only return documentation (Basic Mode). ## Usage ### Natural Language (OpenClaw) Just ask naturally: ``` "What Veeam backup jobs failed yesterday?" "Show me backup repository capacity" "Check Veeam ONE alerts" "Which VMs haven't been backed up this week?" ``` ### Command Line Scripts ```bash # Query VBR ./scripts/query-veeam.sh vbr "What backup jobs ran in the last 24 hours?" # Query Veeam ONE ./scripts/query-veeam.sh vone "Show current alerts" # Test connections ./scripts/test-connection.sh vbr ./scripts/test-connection.sh vone # List available MCP tools ./scripts/list-tools.sh vbr ``` ## How It Works ``` User Question → OpenClaw Skill → Docker MCP Server → Veeam API ↓ Veeam Intelligence ↓ JSON Response ``` 1. **Docker Container**: MCP server runs in isolated container 2. **STDIO Transport**: Communicates via standard input/output 3. **Credential Injection**: Env vars passed securely from credentials file 4. **Natural Language**: Veeam Intelligence processes queries with AI ## Troubleshooting ### Connection Test Fails ```bash # Check credentials file cat ~/.veeam-mcp-creds.json | jq . # Test Docker image docker run -i --rm veeam-intelligence-mcp-server # Manual connection test echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}' | \ docker run -i --rm \ -e PRODUCT_NAME=vbr \ -e WEB_URL=https://your-server:443/ \ -e ADMIN_USERNAME='.\administrator' \ -e ADMIN_PASSWORD='yourpassword' \ -e ACCEPT_SELF_SIGNED_CERT=true \ veeam-intelligence-mcp-server ``` ### Basic Mode (Documentation Only) If responses say "Basic mode is active", enable Veeam Intelligence on your servers. ### Username Format Issues - Try `.\\username` (local account) - Try `DOMAIN\\username` (domain account) - Ensure single backslash in JSON ## Security Notes - Credentials stored locally in `~/.veeam-mcp-creds.json` (chmod 600) - Docker container runs with non-root user - HTTPS connections with self-signed cert acceptance - No credentials exposed in logs or command history - MCP server communicates via stdin/stdout only ## References - Veeam Intelligence MCP Server: Contact Veeam for beta access - [Model Context Protocol](https://modelcontextprotocol.io/) - [Veeam Intelligence Documentation](https://helpcenter.veeam.com/) ## License This skill is provided as-is. Veeam Intelligence MCP server is licensed separately. --- **Need Help?** Open an issue on GitHub or ask in the OpenClaw Discord.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (CRITICAL)