Morning Briefing Agent

An intelligent agent that compiles a comprehensive, personalized morning briefing by pulling data from your email inbox, calendar, weather services, news feeds, and task managers. Supports Gmail, Apple Mail, Outlook, Google Calendar, Todoist, and major weather APIs for a unified start to your day.

Supported Platforms & Integrations

Platform	Setup Method	Auth Type	Notes
Gmail	OAuth 2.0 via Google API	OAuth token	Reads unread, starred, and priority inbox
Apple Mail	Local mailbox access via AppleScript	System permission	macOS only, reads all configured accounts
Outlook / Microsoft 365	Microsoft Graph API	OAuth 2.0	Supports shared mailboxes and focused inbox
Google Calendar	Google Calendar API	OAuth token	Reads today's events + tomorrow preview

When to Use This Agent

• Use this when you want a single, consolidated view of your morning across all platforms
• Use this when you check multiple apps (email, calendar, weather) every morning
• Use this when you want AI-prioritized summaries instead of raw notification lists
• Consider alternatives when you only use one platform (use the specific daily skill instead)

Quick Start

Copy
# Minimal configuration - morning-briefing.yml
agent: morning-briefing
schedule: "07:00"
timezone: "America/New_York"
email:
  provider: gmail
  account: primary
  max_emails: 20
  priority_senders:
    - [email protected]
    - team-[email protected]
calendar:
  provider: google
  calendars: ["primary", "work"]
weather:

Copy
claude /morning-briefing

Expected Output

Good morning! Here is your briefing for Tuesday, March 15, 2026.

WEATHER: New York, NY - 42F, partly cloudy. High of 58F by 2pm.
Rain expected after 6pm, bring an umbrella.

CALENDAR (4 events today):
  09:00 - Sprint Planning (Conference Room B) - 1 hour
  11:30 - 1:1 with Sarah Chen - 30 min
  14:00 - Client demo: Acme Corp - 1 hour [PREP NEEDED]
  17:00 - Team happy hour at Sidebar (optional)

  Tomorrow preview: 3 events, first at 10:00

EMAIL PRIORITY SUMMARY (14 unread):
...

Advanced Configuration

Platform-Specific Setup

Gmail

Copy
email:
  provider: gmail
  accounts:
    - id: work
      address: [email protected]
      labels: ["INBOX", "STARRED"]
      priority_senders: ["[email protected]"]
    - id: personal

Full Options Reference

Parameter	Type	Default	Description
schedule	string	"07:00"	Time to generate briefing (24h format)
timezone	string	system	IANA timezone identifier
email.provider	string	gmail	Email provider: gmail, outlook, apple-mail, imap
email.max_emails	number	20	Maximum emails to include in summary
email.unread_only	boolean	true	Only summarize unread messages
email.priority_senders	array	[]	Email addresses to always highlight

Core Concepts

Concept	Purpose	How It Works
Priority Scoring	Surfaces most important items first	Combines sender importance, keywords, deadlines, and recency
Cross-Source Correlation	Links related items across platforms	Matches calendar events to related emails and tasks
Adaptive Summarization	Adjusts detail level based on volume	More items = shorter summaries; fewer items = richer detail
Time-Aware Filtering	Shows what matters right now	Weights items by time sensitivity and your schedule

Architecture

Gmail/Outlook/IMAP ──> Email Fetcher ──┐
  Google Calendar ──────> Calendar API ──┤
  OpenWeatherMap ───────> Weather API ──┼──> Aggregator ──> Priority Engine ──> Formatter ──> Output

Workflow Examples

Scenario 1: Busy Monday with back-to-back meetings

Input: 8 calendar events, 47 unread emails, 12 tasks due Processing: Agent detects high-load day, switches to ultra-concise mode, flags only 3 critical emails, highlights meeting prep needs, and suggests which tasks to defer. Output: A tight 90-second-read briefing with "Focus on these 3 things today" section at the top.

Scenario 2: Light Friday with strategic planning time

Input: 2 calendar events, 8 unread emails, 3 tasks due Processing: Agent detects open calendar blocks, provides detailed email summaries, and suggests using free time for overdue tasks and weekly reflection. Output: A relaxed briefing with "You have 4 hours of open time today" note and suggested time blocks.

Best Practices

1. Set priority senders carefully -- Start with 5-10 VIP contacts whose emails you always need to see immediately. Review and adjust monthly based on which senders.

2. Use project filters for tasks -- Rather than pulling all tasks, filter to 2-3 key projects. This prevents briefing overload and keeps the focus on what you.

3. Schedule 10 minutes before your routine -- If you start work at 9am, schedule the briefing for 8:50. This gives the agent time to fetch all sources and gives you time to.

Common Issues

1. Gmail API rate limiting -- If you see "quota exceeded" errors, reduce max_emails to 15 and ensure you are not running other Gmail integrations.

2. Calendar events showing wrong timezone -- Verify your timezone setting matches your system timezone. For travel, set timezone to your destination manually or enable.

Privacy & Data Handling

All data processing occurs locally on your machine. Email contents, calendar events, and task details are never sent to external servers beyond the original API providers. The agent caches briefing data in ~/.claude/cache/morning-briefing/ with automatic 24-hour expiration. API tokens are stored in your system keychain (macOS) or credential manager (Linux/Windows).