Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@weather_mcp_server what's the weather in Tokyo?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A fully-featured MCP (Model Context Protocol) server providing real-time and historical weather data for any city worldwide. Powered by the free Open-Meteo API — no API key required.
Tool | Description |
| Real-time weather conditions (temp, humidity, wind, UV, visibility) |
| Multi-day forecast up to 16 days, with optional hourly breakdown |
| Historical daily data going back to 1940 |
| PM2.5, PM10, ozone, NO₂, CO, and US/EU AQI indices |
| Wave heights, periods, and ocean wind forecasts |
| Geocode and disambiguate city names |
Related MCP server: Weather MCP Server
Node.js 18+
npm
git clone <repo-url>
cd weather-mcp-server
npm install
npm run buildstdio mode (for Claude Desktop, Claude Code, etc.):
npm startHTTP mode (for remote/web integrations):
TRANSPORT=http npm start
# Server runs on http://localhost:3000/mcp
# Health check: http://localhost:3000/healthAdd to your claude_desktop_config.json:
{
"mcpServers": {
"weather": {
"command": "node",
"args": ["/path/to/weather-mcp-server/dist/index.js"]
}
}
}Once connected, Claude can answer questions like:
"What's the weather in Tokyo right now?"
"Will it rain in London this weekend?"
"How hot was it in Phoenix in July 2023?"
"What's the air quality in Beijing today?"
"What are the surf conditions in Biarritz this week?"
"Show me a 2-week forecast for Dubai in Fahrenheit"
weather_current{
"location": "Paris",
"temperature_unit": "celsius",
"wind_speed_unit": "kmh"
}weather_forecast{
"location": "New York",
"days": 7,
"include_hourly": false,
"temperature_unit": "fahrenheit"
}weather_historical{
"location": "Sydney",
"start_date": "2024-01-01",
"end_date": "2024-01-31"
}weather_air_quality{
"location": "Delhi"
}weather_marine{
"location": "Miami",
"days": 3
}weather_search_location{
"query": "Springfield",
"count": 5
}weather-mcp-server/
├── src/
│ ├── index.ts # Server entry point & transport setup
│ ├── constants.ts # WMO codes, API URLs, limits
│ ├── types.ts # TypeScript interfaces
│ ├── schemas/
│ │ └── index.ts # Zod validation schemas
│ ├── services/
│ │ └── weatherApi.ts # API client & shared utilities
│ └── tools/
│ ├── currentWeather.ts
│ ├── forecast.ts
│ ├── historical.ts
│ ├── airQuality.ts
│ ├── marine.ts
│ └── geocoding.ts
└── dist/ # Compiled output (run `npm run build`)All data comes from Open-Meteo:
Weather & Forecast: api.open-meteo.com
Historical Archive: archive-api.open-meteo.com
Air Quality: air-quality-api.open-meteo.com
Marine: marine-api.open-meteo.com
Geocoding: geocoding-api.open-meteo.com
Free tier supports unlimited non-commercial use.
MIT
This server cannot be deployed
Global weather via Open-Meteo: forecast, ERA5 archive, marine, air quality, geocoding, elevation.
Real-time weather conditions and multi-day forecasts via Open-Meteo — free, no API key required
Free, keyless real-time weather and 7-day forecasts for any city worldwide.
Global weather API: forecasts, historical data, marine, ski, astronomy and timezone.
