afrexai-email-to-calendar

# Email → Calendar Extraction Engine

Turn emails into structured calendar events with zero missed deadlines.

## Quick Start

When you receive an email (forwarded, pasted, or from inbox):

1. **Parse** — Extract every time-relevant item using the framework below
2. **Classify** — Score each item by type and confidence
3. **Present** — Show structured results with numbered selection
4. **Create** — Use the user's calendar tool to create confirmed events
5. **Follow up** — Track deadlines and send reminders

---

## 1. Extraction Framework

### What to Look For

Scan every email for ALL of these categories:

| Category | Signals | Priority |
|----------|---------|----------|
| **Hard Events** | "meeting at", "call on", "event on", specific date+time | 🔴 High |
| **Deadlines** | "due by", "submit before", "RSVP by", "register by", "expires" | 🔴 High |
| **Soft Events** | "sometime next week", "let's meet soon", "planning for March" | 🟡 Medium |
| **Recurring** | "every Monday", "weekly", "monthly", "standing meeting" | 🟡 Medium |
| **Action Items** | "please review", "can you send", "follow up on", "action required" | 🟡 Medium |
| **Travel/Logistics** | Flight numbers, hotel confirmations, check-in times, gate info | 🔴 High |
| **Implicit Deadlines** | Event is Feb 20 → ticket deadline is likely 1-2 weeks before | 🟡 Medium |

### Extraction Template

For each item found, extract:

```yaml
- title: "Descriptive name (max 80 chars)"
  type: event | deadline | action_item | travel | recurring
  date: "YYYY-MM-DD"
  day_of_week: "Monday"  # Always include for verification
  time_start: "14:00"    # 24h format, default 09:00 if unclear
  time_end: "15:00"      # Default: start + 1h for meetings, all-day for deadlines
  timezone: "America/New_York"  # Extract from email headers or content
  is_all_day: false
  is_multi_day: false     # If true, include end_date
  end_date: null
  recurrence: null        # "weekly" | "biweekly" | "monthly" | "MWF" | custom RRULE
  loc...

# Email → Calendar Extraction Engine

**Turn emails into calendar events with zero missed deadlines.**

The most comprehensive email-to-calendar skill for OpenClaw. No external dependencies — works with any calendar provider.

## What It Does

- 📧 Extracts events, deadlines, action items, and travel logistics from any email
- 🎯 Confidence scoring (high/medium/low) so you know what's solid vs. vague
- ✈️ Special travel mode: flights, hotels, car rentals — all auto-extracted
- ⚠️ Deadline engine with smart reminder scheduling
- 🔄 Duplicate detection before creating events
- 📬 Batch inbox scanning with grouped results
- 🌍 Multi-timezone support with automatic conversion
- 📋 Works with Google Calendar, Apple Calendar, Outlook, Notion, or raw ICS export

## Install

```bash
clawhub install afrexai-email-to-calendar
```

## Quick Start

Forward an email to your agent, or ask it to scan your inbox:

> "Check my inbox for any events or deadlines this week"

> "Here's a travel confirmation — add everything to my calendar"

The agent will extract structured events, present them for review, and create calendar entries on confirmation.

## Why This One?

Most email-to-calendar skills only handle simple "meeting at 2pm" cases. This one handles:

- Multi-day conferences with multiple sessions
- Travel itineraries (flights + hotels + car rentals)
- Deadline detection with action URLs
- Rescheduled/cancelled event updates
- Date ambiguity resolution (MM/DD vs DD/MM)
- Recurring events with exceptions
- ICS attachment parsing

## ⚡ Level Up

Want full industry-specific agent context? Check out our premium packs:

- **[SaaS Context Pack](https://afrexai-cto.github.io/context-packs/)** — Sales pipeline, meeting cadence, customer success workflows ($47)
- **[Professional Services Pack](https://afrexai-cto.github.io/context-packs/)** — Client scheduling, billable hours, project timelines ($47)

Each pack includes 5 deep-context files that make your agent an industry expert.

##...