Trigger: Calendar Event
The Calendar Event trigger fires when a specified calendar event starts or ends. This allows you to automate actions based on your calendar schedule, such as enabling silent mode during meetings or sending reminders before appointments.
Options
- Event Starts - Trigger fires when the calendar event begins
- Event Ends - Trigger fires when the calendar event ends
Configuration
The trigger offers extensive configuration options:
Calendar Selection
- Choose which calendar to monitor from your synced calendars
Availability Filter
- Any - Trigger for all events regardless of availability status
- Busy - Only trigger for events marked as busy
Title Match (Optional)
- Enter text to match against the event title
- Supports regex patterns when enabled
- Case-insensitive matching option available
Detail/Description Match (Optional)
- Enter text to match against the event description
- Supports regex patterns when enabled
Text Matching Options
- Enable Regex - Use regular expressions for pattern matching
- Ignore Case - Perform case-insensitive matching (disabled when regex is enabled)
Event Filtering
- Ignore All Day Events - Exclude all-day events from triggering
Timing Options
- Check in Advance - Fire the trigger before the event starts
- Set days, hours, and minutes in advance
- Use negative values to fire after the event (e.g., 2 hours after end)
- Use Alarm - Ensures more accurate triggering timing for important events
Magic Text
When this trigger fires, the following information is available via magic text:
- Event title - {calendar_title}
- Event description/detail - {calendar_detail}
- Event location - {calendar_location}
- Event start date and time - {calendar_start_date}, {calendar_start_time}
- Event end date and time - {calendar_end_date}, {calendar_end_time}
Examples
Example 1: Silent Mode During Meetings
Triggers Calendar Event - Event Starts (Busy)
Actions Volume Change: Ring to 0 (Silent) Volume Change: Notification to 0
Example 2: Reminder 30 Minutes Before Appointment
Triggers Calendar Event - Event Starts [+30m] (Title: Doctor)
Actions Notification: Doctor appointment in 30 minutes!
Notes
- This trigger normally only fires on 5-minute boundaries (configurable in settings), so events that start between boundaries may fire a few minutes late
- The update rate can be adjusted in MacroDroid settings
- Use the "Use Alarm" option for more accurate timing on important events
- When importing macros, the trigger will attempt to match the calendar by name on the new device
- Regex matching automatically disables the "Ignore Case" option (use regex flags instead)
Permissions Required
- Calendar Permission - READ_CALENDAR permission required to access calendar events
- Schedule Exact Alarm - Required for precise timing
See Also