# ☀️ Morning Briefing MCP Server

**Start your day with full context.** A smart MCP server that generates structured morning briefings combining weather data, calendar events, and intelligently prioritized tasks.

Built for solo founders, freelancers, and productivity enthusiasts who want their AI assistant to deliver a ready-to-act daily briefing.

## ✨ Features

| Tool | What it does |
|------|-------------|
| `briefing_generate` | Complete morning briefing with all sections |
| `briefing_weather` | Current weather + optional 5-day forecast |
| `briefing_calendar_today` | Today's events from Google Calendar |
| `briefing_priorities` | Smart priority extraction from calendar events |

### Smart Priority Engine

Not all calendar events are equal. The priority engine automatically ranks your day:
- 🔴 **High priority**: Meetings, calls, deadlines, reviews
- 🟡 **Medium priority**: Regular events, tasks
- 🟢 **Low priority**: Lunch, breaks, optional items

### Multi-Language Support

Weather descriptions in 40+ languages. Set `lang` to `de`, `fr`, `es`, `ja`, and more.

### Flexible Output

Every tool supports both `markdown` (human-readable) and `json` (machine-readable) output formats.

## 🚀 Quick Start

### 1. Get API Keys

- **Weather**: Free key from [OpenWeatherMap](https://openweathermap.org/api) (1,000 calls/day free)
- **Calendar**: API key from [Google Cloud Console](https://console.cloud.google.com) (optional)

### 2. Install

```bash
pip install morning-briefing-mcp
```

### 3. Configure

Set environment variables:

```bash
export OPENWEATHER_API_KEY="your-key-here"
export GOOGLE_CALENDAR_API_KEY="your-key-here"      # optional
export GOOGLE_CALENDAR_ID="primary"                   # optional
export BRIEFING_DEFAULT_CITY="Vienna"                  # optional
export BRIEFING_UNITS="metric"                         # metric or imperial
export BRIEFING_LANG="en"                              # en, de, fr, es, ...
```

### 4. Add to your MCP client

**Claude Desktop / Cursor / VS Code:**

```json
{
  "mcpServers": {
    "morning-briefing": {
      "command": "python",
      "args": ["-m", "server"],
      "env": {
        "OPENWEATHER_API_KEY": "your-key",
        "BRIEFING_DEFAULT_CITY": "Vienna",
        "BRIEFING_UNITS": "metric",
        "BRIEFING_LANG": "de"
      }
    }
  }
}
```

## 📋 Example Output

```
# ☀️ Morning Briefing
**Tuesday, April 01, 2026** — Generated at 07:00

---

### ☀️ Weather — Vienna
**Clear Sky**
🌡️ 14°C (feels like 12°C)
⬇️ 10°C / ⬆️ 18°C
💧 Humidity: 62%
💨 Wind: 3.2 m/s

### 📅 Today's Schedule
- 🕐 09:00–09:30 — **Team Standup** 📍 Zoom
- 🕐 11:00–12:00 — **Client Review: Q1 Results**
- 🕐 14:00–15:00 — **Strategy Session**
- 📌 All day — **Tax Filing Deadline**

### 🎯 Today's Priorities
1. **Tax Filing Deadline** (all day)
2. **Client Review: Q1 Results** at 11:00
3. **Team Standup** at 09:00
4. **Strategy Session** at 14:00

---
*Powered by Morning Briefing MCP — LIMITLESS Automation*
```

## 🛠️ Use Cases

- **Daily standup prep**: Know your day before your first meeting
- **AI assistant integration**: Let Claude, ChatGPT, or Cursor brief you every morning
- **Automation pipelines**: Feed briefings into Slack, Telegram, or email via n8n/Zapier
- **Team dashboards**: JSON output for custom dashboards and widgets

## 📄 License

MIT — Built by [LIMITLESS Automation](https://limitless-automation.com)

## 🚀 Get Pro

Free tier available on [MCPize](https://mcpize.com/mcp/morning-briefing) — 50 requests/month, no credit card needed. Upgrade to Pro for unlimited daily briefings.

[![Available on MCPize](https://img.shields.io/badge/MCPize-Available-purple)](https://mcpize.com/mcp/morning-briefing)