> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to OpenWeather

The OpenWeather connector lets your AI agent act in each user's OpenWeather account. Each user connects their own OpenWeather API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 16 tools.

**Authentication:** API Key
**Categories:** Productivity, Search
**Tools:** 16: 16 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=OPENWEATHER)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the OpenWeather connection

   In **AgentKit > Connections**, create an OpenWeather connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'openweather'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize OpenWeather:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'openweather_current_weather_by_city_get',
     toolInput: { q: 'YOUR_Q' },
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "openweather"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize OpenWeather:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={"q":"YOUR_Q"},
       tool_name="openweather_current_weather_by_city_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their OpenWeather credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'openweather_air_pollution_forecast_get',
  toolInput: {
    lat: 51.5073,
    lon: -0.1276,
  },
  connector: 'openweather',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="openweather_air_pollution_forecast_get",
    tool_input={
        "lat": 51.5073,
        "lon": -0.1276,
    },
    connection_name="openweather",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `openweather_air_pollution_forecast_get`

Get Air Pollution Forecast · Read-only

Get the hourly air quality forecast for the next 4 days at a latitude and longitude.
Returns the coordinates and a list of entries, each with a Unix timestamp, an air quality index from 1 (Good) to 5 (Very Poor) and concentrations in μg/m3 of CO, NO, NO2, O3, SO2, PM2.5, PM10 and NH3.
Use this for future air quality. Use openweather_air_pollution_get for current readings and openweather_air_pollution_history_get for past readings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_air_pollution_get`

Get Current Air Pollution · Read-only

Get the current air quality at a latitude and longitude.
Returns the coordinates and a list of entries, each with a Unix timestamp, an air quality index from 1 (Good) to 5 (Very Poor) and concentrations in μg/m3 of CO, NO, NO2, O3, SO2, PM2.5, PM10 and NH3.
Use this for air quality right now. Use openweather_air_pollution_forecast_get for the coming days and openweather_air_pollution_history_get for past readings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_air_pollution_history_get`

Get Air Pollution History · Read-only

Get hourly air quality readings for a time range at a latitude and longitude, from 27 November 2020 onward.
Returns the coordinates and a list of entries, each with a Unix timestamp, an air quality index from 1 (Good) to 5 (Very Poor) and concentrations in μg/m3 of CO, NO, NO2, O3, SO2, PM2.5, PM10 and NH3.
Use this for past air quality. Use openweather_air_pollution_get for current readings and openweather_air_pollution_forecast_get for the coming days.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end` (`integer`, required): End of the time range as a Unix timestamp in seconds (UTC); must be after start. Example: 1704153600 (2024-01-02 00:00 UTC)
- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `start` (`integer`, required): Start of the time range as a Unix timestamp in seconds (UTC). Data is available from 27 November 2020 (1606435200). Example: 1704067200 (2024-01-01 00:00 UTC)

Example input: `{"end":1704153600,"lat":51.5073,"lon":-0.1276,"start":1704067200}`

### `openweather_current_weather_by_city_get`

Get Current Weather by City · Read-only

Get the current weather for a city by name.
Returns the weather condition and description, temperature, feels-like temperature, min and max (the spread across stations in a large city right now, not the day's low and high; in most places they equal the current temperature), pressure, humidity, visibility, wind, cloud cover, rain and snow volume for the last hour, sunrise and sunset, the city name and its time zone offset.
Use this when you only have a city name. Use openweather_current_weather_get for coordinates. OpenWeather has deprecated name lookups, so for an ambiguous name resolve it with openweather_location_search first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): City name, optionally followed by a state code (US only) and an ISO 3166 country code, separated by commas. Add the country code to avoid matching a same-named city elsewhere. Example: London,GB or Austin,TX,US
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"q":"<q>"}`

### `openweather_current_weather_by_zip_get`

Get Current Weather by Zip Code · Read-only

Get the current weather for a zip or postal code.
Returns the weather condition and description, temperature, feels-like temperature, min and max (the spread across stations in a large city right now, not the day's low and high; in most places they equal the current temperature), pressure, humidity, visibility, wind, cloud cover, rain and snow volume for the last hour, sunrise and sunset, the city name and its time zone offset.
Use this when you only have a postal code. Use openweather_current_weather_get for coordinates and openweather_current_weather_by_city_get for a city name. OpenWeather has deprecated name and postal-code lookups, so turn the place into coordinates first with openweather_location_search or openweather_location_by_zip_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `zip` (`string`, required): Zip or postal code followed by a comma and the ISO 3166 two-letter country code. Without a country code OpenWeather assumes the US. Example: 94040,US or E14,GB
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"zip":"<zip>"}`

### `openweather_current_weather_get`

Get Current Weather · Read-only

Get the current weather at a latitude and longitude.
Returns the weather condition and description, temperature, feels-like temperature, min and max (the spread across stations in a large city right now, not the day's low and high; in most places they equal the current temperature), pressure, humidity, visibility, wind, cloud cover, rain and snow volume for the last hour, sunrise and sunset, the city name and its time zone offset.
Use this when you have coordinates; it is the most accurate lookup. Use openweather_current_weather_by_city_get for a city name and openweather_current_weather_by_zip_get for a postal code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_forecast_by_city_get`

Get 5-Day Forecast by City · Read-only

Get the 5-day weather forecast in 3-hour steps for a city by name.
Returns a list of up to 40 forecast steps, each with its time, temperature, feels-like temperature, pressure, humidity, weather description, cloud cover, wind, visibility, probability of precipitation and rain or snow volume, plus the city name, coordinates, time zone offset, sunrise and sunset.
Use this when you only have a city name. Use openweather_forecast_get for coordinates and openweather_forecast_by_zip_get for a postal code. OpenWeather has deprecated name and postal-code lookups, so turn the place into coordinates first with openweather_location_search or openweather_location_by_zip_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): City name, optionally followed by a state code (US only) and an ISO 3166 country code, separated by commas. Add the country code to avoid matching a same-named city elsewhere. Example: London,GB or Austin,TX,US
- `cnt` (`integer`, optional): Number of 3-hour forecast steps to return, counted from the next step. The full forecast has up to 40 steps (5 days). Leave empty for all of them. Example: 8 (the next 24 hours)
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"q":"<q>"}`

### `openweather_forecast_by_zip_get`

Get 5-Day Forecast by Zip Code · Read-only

Get the 5-day weather forecast in 3-hour steps for a zip or postal code.
Returns a list of up to 40 forecast steps, each with its time, temperature, feels-like temperature, pressure, humidity, weather description, cloud cover, wind, visibility, probability of precipitation and rain or snow volume, plus the city name, coordinates, time zone offset, sunrise and sunset.
Use this when you only have a postal code. Use openweather_forecast_get for coordinates and openweather_forecast_by_city_get for a city name. OpenWeather has deprecated name and postal-code lookups, so turn the place into coordinates first with openweather_location_search or openweather_location_by_zip_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `zip` (`string`, required): Zip or postal code followed by a comma and the ISO 3166 two-letter country code. Without a country code OpenWeather assumes the US. Example: 94040,US or E14,GB
- `cnt` (`integer`, optional): Number of 3-hour forecast steps to return, counted from the next step. The full forecast has up to 40 steps (5 days). Leave empty for all of them. Example: 8 (the next 24 hours)
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"zip":"<zip>"}`

### `openweather_forecast_get`

Get 5-Day Forecast · Read-only

Get the 5-day weather forecast in 3-hour steps at a latitude and longitude.
Returns a list of up to 40 forecast steps, each with its time, temperature, feels-like temperature, pressure, humidity, weather description, cloud cover, wind, visibility, probability of precipitation and rain or snow volume, plus the city name, coordinates, time zone offset, sunrise and sunset.
Use this for the next 5 days on any API key. Use openweather_forecast_by_city_get for a city name, and openweather_one_call_get for hourly and 8-day daily forecasts (One Call subscription).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `cnt` (`integer`, optional): Number of 3-hour forecast steps to return, counted from the next step. The full forecast has up to 40 steps (5 days). Leave empty for all of them. Example: 8 (the next 24 hours)
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_location_by_zip_get`

Get Location by Zip Code · Read-only

Find the coordinates of a zip or postal code.
Returns the zip code, area name, lat and lon of the code's centroid, and the country code.
Use this to turn a postal code into lat and lon for the coordinate-based tools. Use openweather_location_search for a place name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `zip` (`string`, required): Zip or postal code followed by a comma and the ISO 3166 two-letter country code. Example: 94040,US or E14,GB

Example input: `{"zip":"<zip>"}`

### `openweather_location_reverse_get`

Get Location Name by Coordinates · Read-only

Find the names of places at a latitude and longitude (reverse geocoding).
Returns a list of locations, each with name, local_names (the name in other languages), lat, lon, country code and state where available.
Use this to name the place at given coordinates. Use openweather_location_search to go from a name to coordinates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude in decimal degrees, from -90 to 90. Example: 51.5073
- `lon` (`number`, required): Longitude in decimal degrees, from -180 to 180. Example: -0.1276
- `limit` (`integer`, optional): Maximum number of place names to return. Example: 5

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_location_search`

Search Locations by Name · Read-only

Find the coordinates of a place by its name, with optional state and country.
Returns a list of locations, each with name, local_names (the name in other languages), lat, lon, country code and state where available.
Use this to turn a city name into lat and lon for the weather, forecast, One Call and air pollution tools. Use openweather_location_by_zip_get for a postal code and openweather_location_reverse_get for coordinates to a name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Place name, optionally followed by a state code (US only) and an ISO 3166 country code, separated by commas. Example: London,GB or Springfield,IL,US
- `limit` (`integer`, optional): Maximum number of matching locations to return, from 1 to 5. Example: 5

Example input: `{"q":"<q>"}`

### `openweather_one_call_day_summary_get`

Get Daily Weather Summary · Read-only

Get aggregated weather for one day at a latitude and longitude, from 2 January 1979 up to 1.5 years ahead.
Returns the date and time zone with cloud cover, humidity and pressure in the afternoon, total precipitation, minimum, maximum and morning, afternoon, evening and night temperatures, and the maximum wind speed and direction.
Use this for a whole day's statistics, past or future. Use openweather_one_call_timemachine_get for one exact moment and openweather_one_call_get for the coming 8 days in detail.
Requires the One Call API 3.0 subscription on the OpenWeather account (1,000 free calls a day); other keys get a 401 error.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, required): The day to summarize, in YYYY-MM-DD format, from 1979-01-02 up to 1.5 years ahead. Example: 2024-07-15
- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `tz` (`string`, optional): Time zone offset to use for the day, in ±XX:XX format. Leave empty to use the time zone OpenWeather detects from the coordinates; set it only if that detection is wrong. Example: +03:00
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"date":"<date>","lat":51.5073,"lon":-0.1276}`

### `openweather_one_call_get`

Get One Call Weather · Read-only

Get current weather, a 1-hour minute-by-minute forecast, a 48-hour hourly forecast, an 8-day daily forecast and government weather alerts for a latitude and longitude in one call.
Returns current, minutely, hourly, daily and alerts sections with temperature, feels-like, pressure, humidity, dew point, UV index, cloud cover, visibility, wind, precipitation and weather description; daily entries add a text summary, moon phase and min/max temperatures.
Use this for a full forecast or alerts. Use exclude to drop sections you do not need. Use openweather_forecast_get when the account has no One Call subscription.
Requires the One Call API 3.0 subscription on the OpenWeather account (1,000 free calls a day); other keys get a 401 error.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `exclude` (`string`, optional): Comma-separated list, without spaces, of sections to leave out of the response: current, minutely, hourly, daily, alerts. Leave empty to get all sections. Example: minutely,alerts
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_one_call_overview_get`

Get Weather Overview · Read-only

Get a plain-language weather summary for today or tomorrow at a latitude and longitude, generated by OpenWeather with AI.
Returns the coordinates, time zone, date, units and a weather_overview text describing the conditions and forecast for that day.
Use this to give a user a short readable summary. Use openweather_one_call_get for the numbers behind it.
Requires the One Call API 3.0 subscription on the OpenWeather account (1,000 free calls a day); other keys get a 401 error.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `date` (`string`, optional): The day to summarize in YYYY-MM-DD format: only today or tomorrow, in the time zone of the coordinates. Leave empty for today. Example: 2026-11-16
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"lat":51.5073,"lon":-0.1276}`

### `openweather_one_call_timemachine_get`

Get Weather at a Point in Time · Read-only

Get the weather at a latitude and longitude for one moment, from 1 January 1979 up to 4 days ahead.
Returns the time zone and one data entry with temperature, feels-like, pressure, humidity, dew point, UV index, cloud cover, visibility, wind, rain or snow and weather description, plus sunrise and sunset.
Use this for historical weather at a specific time. Use openweather_one_call_day_summary_get for a whole day's aggregates and openweather_one_call_get for current conditions.
Requires the One Call API 3.0 subscription on the OpenWeather account (1,000 free calls a day); other keys get a 401 error.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dt` (`integer`, required): The moment to get weather for, as a Unix timestamp in seconds (UTC). Any time from 1 January 1979 up to 4 days ahead. Example: 1704067200 (2024-01-01 00:00 UTC)
- `lat` (`number`, required): Latitude of the place in decimal degrees, from -90 to 90. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: 51.5073
- `lon` (`number`, required): Longitude of the place in decimal degrees, from -180 to 180. Get it from openweather_location_search or openweather_location_by_zip_get if you only have a place name or postal code. Example: -0.1276
- `lang` (`string`, optional): Language code for the weather description and city name in the response, such as en, fr, de, es, zh_cn or pt_br. Defaults to English. The full list is at https://openweathermap.org/current#multi. Example: fr
- `units` (`string`, optional): Units of measurement for the response: standard (Kelvin, meters/second), metric (Celsius, meters/second) or imperial (Fahrenheit, miles/hour). Defaults to standard. Example: metric. One of: `standard`, `metric`, `imperial`. Default: `standard`.

Example input: `{"dt":1704067200,"lat":51.5073,"lon":-0.1276}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
