{"id":"c69018e9-4d87-4977-9eb9-d04b90c002a8","slug":"epwtools-python","kind":"mcp","name":"epwtools-python","summary":"Python client, CLI and MCP server for EPW.tools: EnergyPlus weather files (EPW, DDY, STAT) for any location, past years, typical years and future climate","owner":"carlobianchi89","repoUrl":"https://github.com/carlobianchi89/epwtools-python","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-11-04T01:35:21.000Z","addedAt":"2026-11-05T21:23:37.802Z","logoUrl":"https://avatars.githubusercontent.com/u/9423718?u=350c120611bcbf61b757e29ea31d2537cfba95cb&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","data-analytics","utilities"],"tags":["ashrae","building-energy","building-simulation","climate-data","energyplus","epw","future-climate","hvac"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":true,"reviewed":false,"syncedAt":"2026-11-08T01:34:31.243Z","sample":false,"url":"https://conduits.dev/tools/epwtools-python","language":"Python","transports":["stdio"],"install":{"pypi":"epwtools"},"requirements":{"env":[{"name":"EPWTOOLS_API_KEY","secret":true,"required":true,"description":"Your EPW.tools API key (free credits on signup at https://epw.tools)"}],"upstreamMayCharge":false},"tools":null,"readme":"# epwtools\n\n[![carlobianchi89/epwtools-python MCP server](https://glama.ai/mcp/servers/carlobianchi89/epwtools-python/badges/score.svg)](https://glama.ai/mcp/servers/carlobianchi89/epwtools-python)\n[![epwtools on AI Agents Listing](https://aiagentslisting.com/epwtools/badge.svg)](https://aiagentslisting.com/mcp/epwtools)\n[![M8ven Score](https://m8ven.ai/badge/mcp/carlobianchi89-epwtools-python-w8kls1?v=5312ee113fcecc695a39584fb0286e6a)](https://m8ven.ai/mcp/carlobianchi89-epwtools-python-w8kls1?s=readme)\n\nPython client, command-line tool and MCP server for **[EPW.tools](https://epw.tools)**: EnergyPlus weather files\n(EPW, with DDY design days and STAT summaries) for any location on Earth.\n\n- **Actual years** from 1990 to now, for any coordinates, with or without a nearby weather station\n- **Typical years** (TMY), extreme and heatwave years\n- **Future climate** for 2030 to 2100 under SSP scenarios\n- **Design conditions** (ASHRAE method) and short-term **forecast** weather files\n\nThe weather data are built and validated by EPW.tools ([methodology](https://epw.tools/methodology),\n[validation](https://epw.tools/validation)); this package is the open-source way to call them from Python, the\nterminal or an AI assistant.\n\n## Install\n\n```bash\npip install epwtools            # client + CLI\npip install 'epwtools[mcp]'     # + MCP server for AI assistants\n```\n\nGet a free API key at [epw.tools](https://epw.tools) (API tab); the first files are free.\n\n```bash\nexport EPWTOOLS_API_KEY=your-key\n```\n\n## Python\n\n```python\nfrom epwtools import EPWClient\n\nclient = EPWClient()                       # reads EPWTOOLS_API_KEY\n\n# actual year 2023 for a site in Denver\nepw = client.generate(lat=39.74, lon=-104.99, year=2023, name=\"Denver\", out_dir=\"weather\")\n\n# typical year built from 2005-2024\ntmy = client.tmy(lat=45.46, lon=9.19, start=2005, end=2024, name=\"Milan\", out_dir=\"weather\")\n\n# design conditions (ASHRAE method)\ndc = client.design_conditions(lat=51.51, lon=-0.13)\n```\n\n## Command line\n\n```bash\nepwtools configure                          # store your key\nepwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denver\nepwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milan\nepwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYC\nepwtools --help\n```\n\n## AI assistants (MCP)\n\nLet Claude, ChatGPT and other MCP-capable assistants make weather files for you:\n\n```bash\nuvx --from 'epwtools[mcp]' epw-tools-mcp\n```\n\nor use the hosted server, listed in the official MCP Registry. Tools include `generate_epw`, `generate_tmy`,\n`generate_future_climate`, `generate_forecast`, `get_design_conditions` and `get_nearest_stations`.\nSetup guide: [epw.tools/ai-weather-files](https://epw.tools/ai-weather-files).\n\n## Also on EPW.tools (web)\n\n[EPW to CSV / Excel converter](https://epw.tools/epw-to-csv) ·\n[Manual J design temperatures by address](https://epw.tools/manual-j-design-temperatures) ·\n[Construction weather days](https://epw.tools/construction-weather-days) ·\n[Data-centre site climate](https://epw.tools/data-center-weather-data) ·\n[API licence for software vendors](https://epw.tools/api-licensing)\n\n## Licence\n\nThe client, CLI and MCP server in this repository are MIT-licensed. Use of the EPW.tools service and its data is\ngoverned by the EPW.tools terms of service (linked in the footer of [epw.tools](https://epw.tools)).\n"}