🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Veeam MCP
πŸ¦€ ClawHub

Veeam MCP

by @jgm2025

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.

Versionv1.0.3
Downloads2,161
Installs2
#clawhub
TERMINAL
clawhub install veeam-mcp

πŸ“– About This Skill

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:

    cd /path/to/veeam-mcp-server
docker build -t veeam-intelligence-mcp-server .

    2. Install This Skill

    clawhub install veeam-mcp

    Configuration

    Create Credentials File

    Create ~/.veeam-mcp-creds.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: 

    chmod 600 ~/.veeam-mcp-creds.json

    Username Format

  • Local accounts: Use ".\\username" format
  • Domain accounts: Use "DOMAIN\\username" or "username@domain.com"
  • 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

    # 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

    # 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
  • Veeam Intelligence Documentation

    • 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.

    πŸ’‘ Examples

    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

    # 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

    βš™οΈ Configuration

    Create Credentials File

    Create ~/.veeam-mcp-creds.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: 

    chmod 600 ~/.veeam-mcp-creds.json

    Username Format

  • Local accounts: Use ".\\username" format
  • Domain accounts: Use "DOMAIN\\username" or "username@domain.com"
  • 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).

    πŸ“‹ Tips & Best Practices

    Connection Test Fails

    # 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