OpenWeather MCP Server
About
A simple weather forecast MCP (Model Control Protocol) server that provides global weather forecasts and current weather conditions by integrating with the OpenWeatherMap API.
Details
- Transport
- SSE
- License
- MIT license
Explore
- No separate configuration file needed; API key can be passed directly through environment variables or parameters
- Support for querying weather conditions anywhere in the world
- Provides current weather and future forecasts
- Detailed weather information including temperature, humidity, wind speed, etc.
- Support for different time zones
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenWeather MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install mcp-server requests pydantic
export OPENWEATHER_API_KEY="your_api_key" # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key # Windows
Add the following configuration to your MCP-supported client:
{
"weather_forecast": {
"command": "python",
"args": [
"/full_path/weather_mcp_server.py"
],
"env": {
"OPENWEATHER_API_KEY": "your_openweathermap_key_here"
},
"disabled": false,
"autoApprove": ["get_weather", "get_current_weather"]
}
}
AI assistant call example:
User: What's the weather like in New York right now?
AI: Let me check the current weather in New York for you.
[Calling get_current_weather("New York", timezone_offset=-4)]
Current weather in New York: 18°C, partly cloudy, humidity 65%, wind speed 3.5m/s.
```
get_weather
Current weather conditions for a city, right now: temperature (°C), feels-like, humidity, wind speed, and a plain-language description (e.g. "partly cloudy"). Use for any question about the weather at this moment — "what's the weather in Bangkok?", "is it raining in London?", "how hot is it in Tel Aviv?". City name in any language; add a country for ambiguous names ("Springfield, US").
get_forecast
Daily weather forecast for a city, up to 7 days ahead: per-day high/ low (°C), precipitation chance (%), max wind, and conditions. Use for forward-looking questions — "will it rain in Paris this weekend?", "what's the weather in Bangkok next week?", packing or trip-planning questions. `days` = how many days ahead (1-7, default 5).
Run directly without setting environment variables:
python weather_mcp_server.py
When calling the tool, you'll need to provide the api_key parameter.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openweather mcp server": {
"weather-mcp": {
"command": "python",
"args": [
"weather_mcp_server.py"
]
}
}
}
}McpServers
{
"weather-mcp": {
"command": "python",
"args": [
"weather_mcp_server.py"
]
}
}English | 中文版
A simple weather forecast MCP (Model Control Protocol) server providing global weather forecasts and current weather conditions.
Screenshot of Claude Desktop using the MCP Weather Service
Features
- No separate configuration file needed; API key can be passed directly through environment variables or parameters
- Support for querying weather conditions anywhere in the world
- Provides current weather and future forecasts
- Detailed weather information including temperature, humidity, wind speed, etc.
- Support for different time zones
Installation Requirements
pip install mcp-server requests pydantic
Usage
1. Get an OpenWeatherMap API Key
Visit OpenWeatherMap and register an account to obtain an API key.
2. Run the Server
There are two ways to provide the API key:
Method 1: Using Environment Variables
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
