Open-Meteo Weather MCP server

weather-mcp

<!-- mcp-name: io.github.myAI-2025/openmeteo-mcp -->

A minimal Model Context Protocol server in a single file. It speaks JSON-RPC 2.0 over stdio and exposes two tools, getweather and gethourly_forecast, backed by the free Open-Meteo API.

No third-party runtime dependencies — standard library only. Requires Python 3.8+.

Quick start: Claude Code

1. Prepare your terminal

Open Terminal on macOS/Linux or PowerShell on Windows. Paste the command blocks in this guide there. Weather questions and commands beginning with /, such as /login and /mcp, belong inside a Claude Code conversation. If Claude Code is already open in your terminal, use a new terminal tab for setup.

Run claude --version in your terminal to check that it is available. Then run claude and follow the sign-in prompts; if needed, type /login inside Claude Code. Keep a separate terminal tab open for the next steps.

1. Install Claude Code using its official setup guide.

uv supplies uvx, which downloads and runs the weather package for you. Reopen your terminal after installation and run uvx --version. If either version check says “command not found,” finish that installation before continuing.

1. Install uv using the instructions for your operating system.

You need an internet connection to download the package and fetch weather. No weather API key is needed.

2. Add the weather server

Run this in your terminal:

claude mcp add --scope user weather -- uvx myai-weather-mcp==0.1.2

weather is the name you will see in Claude Code. myai-weather-mcp is the published package it runs. User scope makes this setup available across your Claude Code projects. No repository clone or separate package installation is needed. See the Claude Code MCP reference for other setup options.

The ==0.1.2 pin selects the release used in this guide, so a later release does not silently change your setup. It is intentional; see Updating your version when you want to upgrade.

If weather already exists, inspect it with claude mcp get weather. If it already uses the command above, continue to the next step. To replace an older user-scope setup, follow the replacement steps under Updating your version.

3. Check the connection and ask for weather

Run in your terminal:

claude mcp get weather

Look for Connected. If you see a different status or no server is found, use Connection troubleshooting below.

Start a new Claude Code session by running claude, or type /mcp inside an existing session and reconnect weather. At Claude Code's conversation prompt, paste:

• “Use the weather tool to tell me the current weather in Tokyo.”
• “Use the hourly forecast tool to show the next six hours in Tokyo.”

Expect current conditions, temperature in °F, wind in mph, and six forecast rows with local times and rain probabilities. Values change with the weather.

Updating your version

Check the release notes and choose a published version. To replace the user-scope registration, first inspect claude mcp get weather and save any custom settings you want to keep. Then run the following commands, replacing 0.1.2 with your chosen version in the add command:

Shortened. The full README is on GitHub.