View as Markdown
OpenWeather API icon

OpenWeather API ACTION

Get Current Weather Forecast by Location

Retrieves 1-16 days weather forecast for a specified location. See the docs here. For more accurate reading, you are advised to fill in the country and/or state code
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's OpenWeather API account once, then configure and run Get Current Weather Forecast by Location from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "openweather_api-get-weather-forecast-by-location",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    openweather_api: { authProvisionId: "apn_xxxxxxx" },
    city: "City",
    stateCode: "State code",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Current Weather Forecast by Location inputs
Property Type Description
city City string
City location. For example "Houston" in the United States.
Required
stateCode State code string
State code. For example "TX" for Texas.
Optional
countryCode Country Code string
The 2 or 3-letter country code, for example "US" for the United States.
Optional
cnt Days Count integer
Number of days, which will be returned in the API response
Optional
units Units of Measurement string
Standard, metric and imperial units are available. Standard units will be applied by default
Optional
lang Language string
See doc here
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
openweather_api-get-weather-forecast-by-location
Version
0.0.3
App
OpenWeather API
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes