open-meteo-mcp

MCP server for Open-Meteo — free weather APIs, no API key required.

Features

• 16 tools covering weather forecast, historical data, air quality, marine, flood, ensemble, climate projections, and scheduled data collection
• Scheduled jobs — server-side cron, persists readings to SQLite, returns aggregated stats
• No auth — Open-Meteo is free for non-commercial use
• stdio transport — works with Claude Desktop and any MCP client

Tools

Weather data

Weather comparison

Score factors: sunshine, temperature comfort (18–28°C sweet spot), precipitation, wind, UV.

Example prompts:

• "Moscow, Sochi, Kazan this Saturday — where's best?" → compare_weather_cities
• "Best weather within 300 km of Moscow next Sunday?" → compare_weather_region

Scheduled collection

Scheduled jobs survive server restarts — state is persisted in ~/.open-meteo-mcp/data.db.

Installation

git clone https://github.com/langepas/open-meteo-mcp.git
cd open-meteo-mcp
npm install
npm run build

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "open-meteo": {
      "command": "node",
      "args": ["/absolute/path/to/open-meteo-mcp/dist/index.js"]
    }
  }
}

Restart Claude Desktop. Example prompts:

• "What's the weather in Moscow this week?" → geocode → get_forecast
• "Collect temperature in Saint Petersburg every hour" → schedule_weather_job
• "Show me the air quality summary for the last 24h" → get_weather_summary

Development

npm run build          # compile TypeScript
npm test               # run unit tests
npm run dev            # watch mode

Architecture

src/
├── index.ts           # McpServer + StdioServerTransport entry point
├── client.ts          # shared fetch helper (URLSearchParams, arrays → repeated keys)
├── db.ts              # SQLite (better-sqlite3): jobs + readings tables
├── scheduler.ts       # node-cron scheduler, restores jobs on start
└── tools/
    ├── forecast.ts    # get_forecast
    ├── archive.ts     # get_historical
    ├── air-quality.ts # get_air_quality
    ├── marine.ts      # get_marine
    ├── elevation.ts   # get_elevation
    ├── geocoding.ts   # geocode
    ├── flood.ts       # get_flood
    ├── ensemble.ts    # get_ensemble
    ├── climate.ts     # get_climate
    ├── seasonal.ts    # get_seasonal
    ├── dwd-icon.ts    # get_dwd_icon
    ├── ecmwf.ts       # get_ecmwf
    └── schedule.ts    # schedule_weather_job, list_jobs, get_weather_summary, cancel_job

License

MIT