OpenWeatherMap

Overview

OpenWeatherMap is a weather data service that provides visual forecasts, real-time weather conditions, and geographic climate mapping, helping users understand climate patterns or track severe weather conditions. With the integration in SquadOS, your agents can query current weather for any city and convert place names into latitude/longitude coordinates for use in other location-based queries.

• Composio documentation: docs.composio.dev/toolkits/weathermap

Authentication

This tool uses no authentication (NO_AUTH) to connect.

Field	Required	Description
N/A	No	This tool does not require credentials.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for OpenWeatherMap.
3. Click the card to open the details and hit Activate — the tool goes directly to the active list, with no login step. (Connection-flow details in Organization Tools.)

Available actions

Geocode Location to Coordinates

WEATHERMAP_GEOCODE_LOCATION

Tool to resolve a human place name into canonical lat/lon coordinates using OpenWeather Geocoding API. Use when you need to convert location strings (city names, addresses) into coordinates for weather forecasts or other location-based queries. Returns up to 5 candidate matches; the first result is typically the most relevant.

Input parameters

Name	Type	Required	Description
q	string	Yes	Location query string in format city or city,country_code or city,state,country_code. For US locations, you can include state code (e.g., Austin,TX,US). Use ISO 3166 country codes (e.g., London,GB, Paris,FR). The API supports 200,000+ registered locations.
limit	integer	No	Maximum number of location matches to return (1–5). Use this to limit results when multiple locations share the same name. Default is 5.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Weather Info

WEATHERMAP_WEATHER

Tool for querying the OpenWeatherMap API. Returns current weather conditions only — no UV index, AQI, or official alerts. Timestamps are in UTC; apply the timezone offset field before grouping by local day.

Input parameters

Name	Type	Required	Description
location	string	Yes	A real city name (e.g., London, New York, Tokyo). MUST be an actual city name - NOT a placeholder like ‘your location’, ‘current location’, or ‘my location’. City names must be in English/Latin characters only. You may optionally append a country code (e.g., London,GB). For US cities with state abbreviations, use the 3-part format City,StateCode,US (e.g., Redding,CA,US, Portland,OR,US) - the 2-part format City,StateCode will be interpreted as a country code (CA = Canada, not California). If a ‘city not found’ error occurs, retry with a simpler string (e.g., drop state code, use just City or City,CountryCode). Small or remote locations may return no data; handle gracefully rather than retrying indefinitely.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.