EnergyPlus MCP

AI agents load, edit, and run EnergyPlus building energy simulations

Runs as a server Claude Code connects to. It needs its own configuration, and some servers need an API key.

Install just this one

Run in your terminal — needs Node

npx archtmpl@latest --mcp energyplus-mcp

First time? The whole install, step by step

Open Claude Code — the terminal version or the desktop app, either one.
In a terminal, paste the line above and press Enter. In the app, paste it into the chat and ask Claude to run it.
Restart Claude Code. That's the whole install.

What this mcp server does

shell

 1{
 2  "name": "EnergyPlus MCP",
 3  "summary": "AI agents load, edit, and run EnergyPlus building energy simulations",
 4  "repo": "https://github.com/LBNL-ETA/EnergyPlus-MCP",
 5  "preInstall": [
 6    { "shell": "test -d \"$HOME/.claude-arch/energyplus-mcp\" || git clone https://github.com/LBNL-ETA/EnergyPlus-MCP.git \"$HOME/.claude-arch/energyplus-mcp\"" },
 7    { "shell": "cd \"$HOME/.claude-arch/energyplus-mcp\" && docker build -t energyplus-mcp-dev -f .devcontainer/Dockerfile .devcontainer" }
 8  ],
 9  "mcpServers": {
10    "energyplus": {
11      "command": "docker",
12      "args": [
13        "run",
14        "--rm",
15        "-i",
16        "-v", "${HOME}/.claude-arch/energyplus-mcp:/workspace",
17        "-w", "/workspace/energyplus-mcp-server",
18        "energyplus-mcp-dev",
19        "uv", "run", "python", "-m", "energyplus_mcp_server.server"
20      ]
21    }
22  },
23  "postInstallNotes": "Official Lawrence Berkeley National Laboratory implementation, BSD-style license (GitHub labels it 'Other'). Requires Docker running; the image build is a one-time step and the container carries EnergyPlus, so the README's only prerequisites are Docker and git."
24}
25

Back to all MCPs

Install just this one

Run in your terminal — needs Node

npx archtmpl@latest --mcp energyplus-mcp

First time? The whole install, step by step

Open Claude Code — the terminal version or the desktop app, either one.
In a terminal, paste the line above and press Enter. In the app, paste it into the chat and ask Claude to run it.
Restart Claude Code. That's the whole install.

What this mcp server does

shell

 1{
 2  "name": "EnergyPlus MCP",
 3  "summary": "AI agents load, edit, and run EnergyPlus building energy simulations",
 4  "repo": "https://github.com/LBNL-ETA/EnergyPlus-MCP",
 5  "preInstall": [
 6    { "shell": "test -d \"$HOME/.claude-arch/energyplus-mcp\" || git clone https://github.com/LBNL-ETA/EnergyPlus-MCP.git \"$HOME/.claude-arch/energyplus-mcp\"" },
 7    { "shell": "cd \"$HOME/.claude-arch/energyplus-mcp\" && docker build -t energyplus-mcp-dev -f .devcontainer/Dockerfile .devcontainer" }
 8  ],
 9  "mcpServers": {
10    "energyplus": {
11      "command": "docker",
12      "args": [
13        "run",
14        "--rm",
15        "-i",
16        "-v", "${HOME}/.claude-arch/energyplus-mcp:/workspace",
17        "-w", "/workspace/energyplus-mcp-server",
18        "energyplus-mcp-dev",
19        "uv", "run", "python", "-m", "energyplus_mcp_server.server"
20      ]
21    }
22  },
23  "postInstallNotes": "Official Lawrence Berkeley National Laboratory implementation, BSD-style license (GitHub labels it 'Other'). Requires Docker running; the image build is a one-time step and the container carries EnergyPlus, so the README's only prerequisites are Docker and git."
24}
25