EnergyPlus MCP

Name: EnergyPlus MCP
Author: Lawrence Berkeley National Laboratory

Lawrence Berkeley National Laboratory

Get started Repository

Lets agents load, validate, modify, run and analyze EnergyPlus building energy simulation models.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add energyplus -- docker run --rm -i -v /path/to/EnergyPlus-MCP:/workspace -w /workspace/energyplus-mcp-server energyplus-mcp-dev uv run python -m energyplus_mcp_server.server

~/.codex/config.toml

[mcp_servers.energyplus]
command = "docker"
args = ["run", "--rm", "-i", "-v", "/path/to/EnergyPlus-MCP:/workspace", "-w", "/workspace/energyplus-mcp-server", "energyplus-mcp-dev", "uv", "run", "python", "-m", "energyplus_mcp_server.server"]

# codex mcp add energyplus -- docker run --rm -i -v /path/to/EnergyPlus-MCP:/workspace -w /workspace/energyplus-mcp-server energyplus-mcp-dev uv run python -m energyplus_mcp_server.server

~/.cursor/mcp.json

{
  "mcpServers": {
    "energyplus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/EnergyPlus-MCP:/workspace",
        "-w",
        "/workspace/energyplus-mcp-server",
        "energyplus-mcp-dev",
        "uv",
        "run",
        "python",
        "-m",
        "energyplus_mcp_server.server"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "energyplus": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/EnergyPlus-MCP:/workspace",
        "-w",
        "/workspace/energyplus-mcp-server",
        "energyplus-mcp-dev",
        "uv",
        "run",
        "python",
        "-m",
        "energyplus_mcp_server.server"
      ]
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "energyplus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/EnergyPlus-MCP:/workspace",
        "-w",
        "/workspace/energyplus-mcp-server",
        "energyplus-mcp-dev",
        "uv",
        "run",
        "python",
        "-m",
        "energyplus_mcp_server.server"
      ]
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "energyplus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/EnergyPlus-MCP:/workspace",
        "-w",
        "/workspace/energyplus-mcp-server",
        "energyplus-mcp-dev",
        "uv",
        "run",
        "python",
        "-m",
        "energyplus_mcp_server.server"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "energyplus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/EnergyPlus-MCP:/workspace",
        "-w",
        "/workspace/energyplus-mcp-server",
        "energyplus-mcp-dev",
        "uv",
        "run",
        "python",
        "-m",
        "energyplus_mcp_server.server"
      ]
    }
  }
}

Setup

Related