← Back to docs
Recipe

Recipe: Email → calendar event

Extract dates, times, and locations from inbound emails and create calendar events automatically via Meridian workflows.

Overview

This recipe watches a designated inbox folder. When a new email arrives, Meridian parses the body for date/time patterns, extracts any location strings, and pushes a structured event payload to your calendar provider — Google Calendar, Outlook, or a custom webhook.

Prerequisites

  • Meridian agent v2.4+ installed and licensed
  • IMAP access enabled on the source mailbox
  • Calendar provider API key stored in Meridian vault

Trigger configuration

trigger:
  type: imap_poll
  host: imap.example.com
  port: 993
  folder: INBOX/Events
  interval_seconds: 60

Extraction rules

Meridian uses a built-in NLP model to detect:

  • Absolute dates (March 15, 2026)
  • Relative dates (next Tuesday, tomorrow at 3pm)
  • Time ranges (2:00–3:30 PM EST)
  • Location strings following prepositions (at, in, near)

Calendar push

action:
  type: calendar_create
  provider: google
  default_duration_minutes: 60
  reminders:
    - 10m
    - 1h

Testing the recipe

Send a test email to the monitored folder with a clear date and location in the body. Check the Meridian dashboard under Workflows → Logs for the parsed payload before it reaches your calendar.

Need help? Browse more recipes or open a ticket from the dashboard.