> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenWeatherMap

> WeatherMap provides visual weather data, forecasts, and mappings, helping users understand climate patterns or track severe weather conditions

![OpenWeatherMap logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/weathermap.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=2d3f10acd1e3e5cf97a0abd4b7615371)

* **Category:** places & weather
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 2
* **Triggers:** 0
* **Slug:** `WEATHERMAP`
* **Version:** 20261101\_00

## Tools

> [accordion] Geocode Location to Coordinates
>
> **Slug:** `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
>
> **q** `string` *required*
>
> 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`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Weather Info
>
> **Slug:** `WEATHERMAP_WEATHER`
>
> Get current weather conditions for a city using OpenWeatherMap; timestamps are in UTC, with a timezone offset for local grouping. Two-part city queries ending in a US state code are automatically interpreted as US locations, even when the code also represents a country.
>
> #### Input Parameters
>
> **location** `string` *required*
>
> 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 (e.g., '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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
