tomorrow-weather

tomorrow-weather

A Claude Code plugin that gives Claude full access to the Tomorrow.io weather API — real-time conditions, forecasts, historical data, air quality, alerts, route weather, and location management.

What it adds to Claude

Skill	Command	Description
Current weather	/weather-now	Real-time conditions for any location
Forecast	/weather-forecast	Daily or hourly forecasts up to 14 days
Historical	/weather-history	Past weather back to year 2000
Air quality	/weather-air-quality	AQI, pollen, fire index, UV
Alerts	/weather-alerts	Active severe weather warnings

Beyond skills, the plugin exposes an MCP server with 7 tools Claude can call directly:

• get_realtime_weather — current conditions
• get_forecast — Timeline API (1-minute, hourly, or daily)
• get_historical_weather — historical data back to 2000
• get_alerts — active severe weather events
• get_air_quality — AQI, pollen, fire index, pollutants
• get_route_weather — weather along a travel route
• manage_locations — create/list/delete saved locations

Requirements

• Claude Code v1.0.33 or later
• Node.js v18 or later
• A Tomorrow.io API key — get one free at app.tomorrow.io/development/keys

Setup

1. Set your API key

Add your Tomorrow.io API key to your environment. The plugin reads it from TOMORROW_API_KEY:

export TOMORROW_API_KEY=your_api_key_here

Add that line to your ~/.zshrc or ~/.bashrc to make it permanent.

2. Install the plugin

Option A — Install from the official Anthropic marketplace (once listed)

/plugin install tomorrow-weather@claude-plugins-official

Option B — Install directly from this GitHub repo

/plugin marketplace add chidinwaka/tomorrow-weather-plugin
/plugin install tomorrow-weather@tomorrow-weather-marketplace

Option C — Install locally (development)

git clone https://github.com/chidinwaka/tomorrow-weather-plugin
cd tomorrow-weather-plugin/mcp-server
npm install

Then in Claude Code:

/plugin marketplace add /path/to/tomorrow-weather-plugin
/plugin install tomorrow-weather@tomorrow-weather-marketplace

3. Use it

/weather-now London
/weather-forecast "New York" 7
/weather-history "Tokyo" --start 2023-08-01 --end 2023-08-07
/weather-air-quality "Los Angeles"
/weather-alerts "Miami"

Or just ask Claude naturally:

"What's the weather in Lagos right now?" "Will it rain in Berlin this weekend?" "What was the temperature in Sydney last December?"

API coverage

This plugin covers the full Tomorrow.io v4 API surface:

API	Endpoint	Tool
Realtime	POST /weather/realtime	get_realtime_weather
Timeline (forecast + history)	POST /timelines	get_forecast, get_historical_weather, get_air_quality
Events / Alerts	POST /events	get_alerts
Routes	POST /route	get_route_weather
Locations	GET/POST/DELETE /locations	manage_locations

80+ data fields are available including temperature, precipitation, humidity, wind, UV, AQI, pollen, fire index, soil moisture, solar irradiance, lightning, visibility, and more.

License

MIT