Skip to content
Tresca

OpenStudio MCP Server

MCP serverCommunity

A Docker-based MCP server for inspecting OpenStudio OSM models, modelled on LBNL's EnergyPlus server. By roruizf.

11 starsUpdated 11 months agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
OpenStudio
How it connects
Reads and writes files; the tool isn't needed
Access
Can modify models
Tool versions
OpenStudio 3.7.0 (in the Docker image)
Operating systems
Windows, macOS, Linux
Needs a OpenStudio licence
No
Transport
Local (stdio)
AI clients documented
Claude Desktop, VS Code, Cursor
Licence
MIT
Language
Python

What it can do

  • Loads and saves OSM files and converts them to EnergyPlus IDF.
  • Lists spaces, thermal zones, materials, air loops, people, lighting and equipment loads and schedule rulesets.
  • Applies ASHRAE 90.1 space type and construction set templates and generates an HTML model view.
  • Built on the author's OpenStudio-Toolkit Python library.

Limitations

  • Mostly read and inspect tools; there is no simulation run tool in the documented list.
  • Docker is required.
  • Last updated December 2025 at check.

Install

git clone https://github.com/roruizf/openstudio-mcp-server.git
cd openstudio-mcp-server
docker build -t openstudio-mcp-dev -f .devcontainer/Dockerfile .devcontainer

Source: github.com/roruizf/openstudio-mcp-server#quick-start-docker---recommended

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.