# Google Weather MCP

MCP server for the [Google Maps Platform Weather API](https://developers.google.com/maps/documentation/weather/overview), plus a dashboard that calls the same tools over HTTP.

## What you get

- **MCP tools** (stdio) for Cursor / Claude Desktop:
  - `geocode_location`
  - `get_current_weather`
  - `get_hourly_forecast`
  - `get_daily_forecast`
  - `get_weather_dashboard`
- **Frontend** at `http://localhost:8787` — current conditions, 24-hour strip, 10-day forecast.

The API key stays on the server. The browser never sees it.

## Setup

```bash
cd google-weather-mcp
npm install
cp .env.example .env
```

Enable **Weather API** in a Google Cloud project and put the key in `.env`:

```
GOOGLE_WEATHER_API_KEY=your_key_here
```

Optional: enable **Geocoding API** on the same key (or set `GOOGLE_GEOCODING_API_KEY`). Without it, city search uses OpenStreetMap Nominatim.

Without a key, the dashboard still runs with **demo weather** so you can check the UI.

## Run the dashboard

```bash
npm start
```

Open [http://localhost:8787](http://localhost:8787). Search a city or use your location.

## Run as an MCP server

```bash
npm run mcp
```

Cursor MCP config (`~/.cursor/mcp.json` or project `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "google-weather": {
      "command": "npx",
      "args": ["tsx", "src/mcp.ts"],
      "cwd": "/Users/rajendrasrirangan/Downloads/AI_Projects/google-weather-mcp",
      "env": {
        "GOOGLE_WEATHER_API_KEY": "your_key_here"
      }
    }
  }
}
```

After adding it, ask the agent for weather in a city. It will call `get_weather_dashboard` (or the more specific tools).

## Google endpoints used

- `GET https://weather.googleapis.com/v1/currentConditions:lookup`
- `GET https://weather.googleapis.com/v1/forecast/hours:lookup`
- `GET https://weather.googleapis.com/v1/forecast/days:lookup`