EPW.tools MCP server

Q: How do I add EPW.tools MCP to Claude Code?

Run `claude mcp add --env EPWTOOLS_API_KEY= epwtools-python -- uvx epwtools` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add EPW.tools MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Nov 8, 2026

carlobianchi89/epwtools-python · python · MIT

Allows AI clients to generate EnergyPlus weather files, typical years, future climate scenarios, and design conditions for any location on Earth.

Also known as carlobianchi89/epwtools-python, epwtools-python, epwtools

stdio remote Science & Research

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: 191
Latest version: 0.5.3
Last commit: Nov 8, 2026
License: MIT

What is EPW.tools MCP?

EPW.tools allows AI clients to generate EnergyPlus weather files, typical years, future climate scenarios, and design conditions for any location on Earth.

Summary generated from the project's README

About EPW.tools MCP server

EPW.tools provides an MCP server that allows AI assistants to generate specialized EnergyPlus weather files for any location on Earth. This tool is designed for building energy modelers and researchers who need precise meteorological data. It functions as a remote service that requires an API key from the EPW.tools website to access data beyond the initial free files.

Users can request various data types including actual years from 1990 to the present, typical years (TMY), extreme or heatwave years, and future climate scenarios ranging from 2030 to 2100 under SSP scenarios. The server also provides ASHRAE method design conditions and short-term forecast files. Through specific tools like generate_epw, generate_tmy, and generate_future_climate, an AI client can automate the creation of EPW, DDY design days, and STAT summaries for complex simulation workflows.

What you can do with it

1Generate historical weather filesRequest an EnergyPlus weather file for a specific year and coordinate to simulate past building performance.
2Model future climate impactsCreate weather files for future years using specific SSP scenarios to study long-term climate changes.
3Obtain ASHRAE design conditionsRetrieve design temperature data using the ASHRAE method for a specific latitude and longitude.
4Create typical meteorological yearsGenerate a TMY file based on a specific range of historical years for a given location.

Written from the project's README. Every use case is checked against a quote from it.

How to install EPW.tools MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY> epwtools-python -- uvx epwtools

~/.cursor/mcp.json

{
  "mcpServers": {
    "epwtools-python": {
      "command": "uvx",
      "args": [
        "epwtools"
      ],
      "env": {
        "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "epwtools-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "epwtools"
      ],
      "env": {
        "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "epwtools-python": {
      "command": "uvx",
      "args": [
        "epwtools"
      ],
      "env": {
        "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.epwtools-python]
command = "uvx"
args = ["epwtools"]

[mcp_servers.epwtools-python.env]
EPWTOOLS_API_KEY = "<YOUR_EPWTOOLS_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "epwtools-python": {
      "command": "uvx",
      "args": [
        "epwtools"
      ],
      "env": {
        "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
      }
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

EPWTOOLS_API_KEYRequiredSecret
Your EPW.tools API key (free credits on signup at https://epw.tools)

Name	Description
EPWTOOLS_API_KEY	Your EPW.tools API key (free credits on signup at https://epw.tools)	RequiredSecret

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

epwtools

Python client, command-line tool and MCP server for EPW.tools: EnergyPlus weather files (EPW, with DDY design days and STAT summaries) for any location on Earth.

Actual years from 1990 to now, for any coordinates, with or without a nearby weather station
Typical years (TMY), extreme and heatwave years
Future climate for 2030 to 2100 under SSP scenarios
Design conditions (ASHRAE method) and short-term forecast weather files

The weather data are built and validated by EPW.tools (methodology, validation); this package is the open-source way to call them from Python, the terminal or an AI assistant.

Install

pip install epwtools            # client + CLI
pip install 'epwtools[mcp]'     # + MCP server for AI assistants

Get a free API key at epw.tools (API tab); the first files are free.

export EPWTOOLS_API_KEY=your-key

Python

from epwtools import EPWClient

client = EPWClient()                       # reads EPWTOOLS_API_KEY

# actual year 2023 for a site in Denver
epw = client.generate(lat=39.74, lon=-104.99, year=2023, name="Denver", out_dir="weather")

# typical year built from 2005-2024
tmy = client.tmy(lat=45.46, lon=9.19, start=2005, end=2024, name="Milan", out_dir="weather")

# design conditions (ASHRAE method)
dc = client.design_conditions(lat=51.51, lon=-0.13)

Command line

epwtools configure                          # store your key
epwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denver
epwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milan
epwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYC
epwtools --help

AI assistants (MCP)

Let Claude, ChatGPT and other MCP-capable assistants make weather files for you:

uvx --from 'epwtools[mcp]' epw-tools-mcp

or use the hosted server, listed in the official MCP Registry. Tools include generate_epw, generate_tmy, generate_future_climate, generate_forecast, get_design_conditions and get_nearest_stations. Setup guide: epw.tools/ai-weather-files.

Also on EPW.tools (web)

EPW to CSV / Excel converter · Manual J design temperatures by address · Construction weather days · Data-centre site climate · API licence for software vendors

Licence

The client, CLI and MCP server in this repository are MIT-licensed. Use of the EPW.tools service and its data is governed by the EPW.tools terms of service (linked in the footer of epw.tools).

Read full README

EPW.tools MCP questions

How do I add EPW.tools MCP to Claude Code?

Run claude mcp add --env EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY> epwtools-python -- uvx epwtools in your terminal. Add --scope user to make it available in every project.

How do I add EPW.tools MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Does it support future climate projections?

Yes, it provides future climate data from 2030 to 2100 under various SSP scenarios.

How do I get started with the MCP server?

You can run the server using uvx with the command uvx --from 'epwtools[mcp]' epw-tools-mcp.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: 191
Latest version: 0.5.3
Last commit: Nov 8, 2026
License: MIT
Transport: stdio, remote
Package: epwtools

carlobianchi89 ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/carlobianchi89/epwtools-python.svg)](https://hostedmcp.org/servers/carlobianchi89/epwtools-python/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About EPW.tools MCP server

What you can do with it

1Generate historical weather filesRequest an EnergyPlus weather file for a specific year and coordinate to simulate past building performance.
2Model future climate impactsCreate weather files for future years using specific SSP scenarios to study long-term climate changes.
3Obtain ASHRAE design conditionsRetrieve design temperature data using the ASHRAE method for a specific latitude and longitude.
4Create typical meteorological yearsGenerate a TMY file based on a specific range of historical years for a given location.

Written from the project's README. Every use case is checked against a quote from it.

{ "mcpServers": { "epwtools-python": { "command": "uvx", "args": [ "epwtools" ], "env": { "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>" } } } }

{ "servers": { "epwtools-python": { "type": "stdio", "command": "uvx", "args": [ "epwtools" ], "env": { "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>" } } } }

{ "mcpServers": { "epwtools-python": { "command": "uvx", "args": [ "epwtools" ], "env": { "EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>" } } } }

Name

Description

EPWTOOLS_API_KEY

Your EPW.tools API key (free credits on signup at https://epw.tools)

RequiredSecret

from epwtools import EPWClient client = EPWClient() # reads EPWTOOLS_API_KEY # actual year 2023 for a site in Denver epw = client.generate(lat=39.74, lon=-104.99, year=2023, name="Denver", out_dir="weather") # typical year built from 2005-2024 tmy = client.tmy(lat=45.46, lon=9.19, start=2005, end=2024, name="Milan", out_dir="weather") # design conditions (ASHRAE method) dc = client.design_conditions(lat=51.51, lon=-0.13)

epwtools configure # store your key epwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denver epwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milan epwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYC epwtools --help

EPW.tools MCP questions

How do I add EPW.tools MCP to Claude Code?

Run claude mcp add --env EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY> epwtools-python -- uvx epwtools in your terminal. Add --scope user to make it available in every project.

How do I add EPW.tools MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Does it support future climate projections?

Yes, it provides future climate data from 2030 to 2100 under various SSP scenarios.

How do I get started with the MCP server?

You can run the server using uvx with the command uvx --from 'epwtools[mcp]' epw-tools-mcp.

EPW.tools MCP server

What is EPW.tools MCP?

About EPW.tools MCP server

What you can do with it

How to install EPW.tools MCP

Install EPW.tools MCP in Claude Code

Install EPW.tools MCP in Cursor

Install EPW.tools MCP in VS Code

Install EPW.tools MCP in Claude Desktop

Install EPW.tools MCP in Codex

Install EPW.tools MCP in Gemini CLI

Configuration

Automated checks

README

epwtools

Install

Python

Command line

AI assistants (MCP)

Also on EPW.tools (web)

Licence

EPW.tools MCP questions

EPW.tools MCP server

What is EPW.tools MCP?

About EPW.tools MCP server

What you can do with it

How to install EPW.tools MCP

Install EPW.tools MCP in Claude Code

Install EPW.tools MCP in Cursor

Install EPW.tools MCP in VS Code

Install EPW.tools MCP in Claude Desktop

Install EPW.tools MCP in Codex

Install EPW.tools MCP in Gemini CLI

Configuration

Automated checks

README

epwtools

Install

Python

Command line

AI assistants (MCP)

Also on EPW.tools (web)

Licence

EPW.tools MCP questions