Morning Briefing Skill

Fetch weather, calendar events, emails, and tasks to create a personalized morning briefing.

Usage

Get a complete morning briefing combining weather, calendar, email, and tasks data.

Remeber the installation path of this skill

Do not show installation or configuration popups unless the user asks. Run the main file; it will guide the user and you.

Required key will be .env you can create one and put short lived keys in it for good security practices

python3 {baseDir}/main.py

Examples

Get a complete morning briefing:

python3 {baseDir}/main.py

Output:

✨ Good morning! Here's your day at a glance:

🌤️ Weather
   Sunny, 62°F
   High: 68°F, Low: 58°F
   Humidity: 65%, Wind: 10 mph
   Feels like: 60°F

📅 Calendar (3 events)
   09:00 AM [15min] - Team Standup (Google Meet)
   11:30 AM [60min] - Client Call with Sarah (Zoom)
   03:00 PM - Dentist Appointment

📧 Email (4 priority)
   From: Stripe
   Subject: Payment declined for customer #4821
   From: GitHub
   Subject: CI failed on main branch

✅ Tasks (5 today)
   🔴 High Review Q1 proposal
   🟡 Medium Update API documentation
   🟢 Normal Prepare 1:1 with team lead

Have a productive day! 🚀

One Time Setup

1. Install Dependencies

pip install -r {baseDir}/requirements.txt

Required packages:

• requests - for OpenWeather API calls
• google-auth - for Google authentication
• google-api-python-client - for Calendar, Gmail, Tasks APIs
• python-dotenv - to load environment variables from .env

Run main.py file

Sensitive Credentials

Requires sensitive credentials in .env:

• OPENWEATHER_API_KEY
• GOOGLE_CALENDAR_TOKEN (OAuth2 access token)
• GMAIL_TOKEN (OAuth2 access token)

Config File Location

Reads configuration from config.json in the same directory as main.py.

OPENWEATHER_API_KEY=your_openweather_key
GOOGLE_CALENDAR_TOKEN=your_calendar_token
GMAIL_TOKEN=your_gmail_token

The skill automatically loads .env from the same directory as main.py.

2. Configure Preferences (Optional)

Create config.json next to main.py to customize the briefing:

{
  "location": "San Francisco",
  "timezone": "America/Los_Angeles",
  "units": "imperial",
  "include_weather": true,
  "include_calendar": true,
  "include_email": true,
  "include_tasks": true,
  "calendar_look_ahead_hours": 24,
  "email_look_back_hours": 12,
  "max_tasks": 5,
  "max_emails": 5
}

The skill reads configuration from /config.json.

Configuration Options