Open-source weather data ecosystem for Claude Desktop and AI assistants.

Weather MCP is a comprehensive Model Context Protocol (MCP) ecosystem that brings real-world weather data to AI assistants like Claude Desktop. It consists of three main components working together to provide weather intelligence, analytics insights, and community resources.

✅ 12 Weather Tools - Forecasts, alerts, historical data, air quality, marine conditions, and more ✅ Multi-Provider Support - Automatic fallback between NOAA and Open-Meteo ✅ Global Coverage - US-focused with NOAA, worldwide with Open-Meteo ✅ No API Keys Required - Free access to all weather data ✅ Privacy-First Analytics - Optional, anonymous usage tracking ✅ Open Source - MIT licensed, community-driven

# Install via npm
npm install -g @dangahagan/weather-mcp

# Or clone and build from source
git clone https://github.com/weather-mcp/weather-mcp.git
cd mcp-server
npm install
npm run build

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@dangahagan/weather-mcp"]
    }
  }
}

Ask Claude:

• "What's the weather forecast for Seattle this week?"
• "Are there any weather alerts for Miami?"
• "Show me historical weather data for New York in July 2020"

📖 Full Installation Guide →

📖 Full API Reference →

Weather MCP respects your privacy:

• No API Keys Required - All weather APIs are free and public
• Optional Analytics - Opt-in only, disabled by default
• Anonymous Data - No PII, coordinates, or location names collected
• Open Source - All code is auditable
• Transparent - Public analytics dashboard showing aggregate usage

📖 Privacy Policy →

We welcome contributions to any Weather MCP project!

• 🐛 Report Bugs - Open an issue in the relevant repository
• 💡 Suggest Features - Share your ideas in GitHub Discussions
• 📝 Improve Documentation - Help make our docs better
• 🔧 Submit Pull Requests - Fix bugs or add features
• ⭐ Star Our Repos - Show your support!

1. Choose a project to contribute to:

   • MCP Server - Node.js/TypeScript
   • Analytics Server - Fastify/PostgreSQL
   • Website - Next.js/React

2. Read the contributing guide for that project

3. Fork, code, and submit a PR following the project's guidelines

📖 Contributing Guide →

• ✅ Production-ready MCP server
• ✅ 12 weather tools with comprehensive coverage
• ✅ Multi-provider support with automatic fallback
• ✅ Extensive testing and documentation

• ✅ Public website launched (weather-mcp.dev)
• 🚧 Analytics server deployment (in development)
• 🚧 Analytics dashboard launch
• 🚧 Optional opt-in analytics for product improvement
• 🚧 Additional weather providers (NWS, etc.)

• 📋 Mobile app integration
• 📋 Plugin system for custom data sources
• 📋 Real-time weather alerts via WebSocket
• 📋 Community showcase and examples

📖 Full Roadmap →

• GitHub Discussions - Ask questions, share ideas
• Discord Server - Real-time chat with the community
• Twitter - Updates and announcements
• Website - Official Weather MCP website

• MCP Server Documentation
• API Reference
• Installation Guide
• Configuration Options

• Model Context Protocol Spec
• NOAA API Documentation
• Open-Meteo API Documentation

• Security Policy
• License (MIT)
• Code of Conduct

Weather MCP is free and open source. If you find it useful, consider supporting the project:

• General Inquiries: hello@weather-mcp.dev
• Security Issues: security@weather-mcp.dev
• Twitter: @weather_mcp

All Weather MCP projects are licensed under the MIT License.

Copyright (c) 2025 Dan Gahagan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.