Victron VRM MCP Server

A Model Context Protocol (MCP) server that provides read-only access to Victron VRM data.

Features

• Read-only access to Victron VRM API v2
• Complete implementation of all 41 GET endpoints
• Supports comprehensive VRM monitoring:
  • User & authentication management
  • Installation discovery and search
  • Real-time system overview
  • Time-series statistics and forecasts
  • Aggregated energy totals
  • Alarms and warnings
  • Detailed diagnostics
  • 20+ widget endpoints for specific device data
  • Data export in CSV/Excel formats
  • GPS tracking for mobile installations
• Full input validation and error handling
• Rate limiting awareness (200 requests rolling window)
• Comprehensive test coverage

Installation

npm install
npm run build

Configuration

Set the following environment variables:

• VRM_TOKEN (required): Your VRM personal access token
• VRM_BASE_URL (optional): Default is https://vrmapi.victronenergy.com/v2
• VRM_TOKEN_KIND (optional): Either Token (default) or Bearer

You can set these via shell env or a local .env file (auto‑loaded via dotenv). Example .env:

VRM_TOKEN=your-token-here
VRM_BASE_URL=https://vrmapi.victronenergy.com/v2
VRM_TOKEN_KIND=Token

Getting a VRM Token

1. Log into VRM Portal
2. Go to Preferences → Integrations → Access tokens
3. Create a new personal access token
4. Copy the token and set it as VRM_TOKEN

Usage

As MCP Server (stdio)

# Option A: env inline
VRM_TOKEN=your-token-here npm start

# Option B: use .env (recommended)
echo "VRM_TOKEN=your-token-here" > .env
npm start

Claude Desktop Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "vrm": {
      "command": "node",
      "args": ["/path/to/victron_vrm_mcp/dist/index.js"],
      "env": {
        "VRM_TOKEN": "your-token-here" // or omit if using .env alongside the binary
      }
    }
  }
}

Available Tools (41 Total)

Core Monitoring (8 tools)

• vrm_get_user_me - Get current user information including user ID
• vrm_list_installations - List all installations accessible to the user
• vrm_get_system_overview - Get high-level system overview for a site
• vrm_get_stats - Time-series statistics (venus, live_feed, consumption, kwh, solar_yield, forecast)
• vrm_get_overall_stats - Aggregated totals for attribute codes over a period
• vrm_get_alarms - Retrieve alarms for a site
• vrm_get_diagnostics - Get most recent diagnostic datapoints
• vrm_get_widget_graph - Widget graph data for specific device instances

Authentication & User Management (4 tools)

• vrm_auth_login_as_demo - Login as demo account
• vrm_auth_logout - Logout from current session
• vrm_search_user_installations - Search through user’s installations

Data Export & Downloads (5 tools)

• vrm_download_installation_data - Download data in CSV/Excel formats with optional parsing