Command
nylas calendar ai analyze
Analyze meeting patterns and get AI recommendations.
Written by Qasim Muhammad Staff SRE
What does nylas calendar ai analyze do?
The nylas calendar ai analyze command studies your historical calendar data to surface meeting-acceptance patterns, actual vs scheduled durations, timezone preferences, and peak focus times, then returns AI recommendations for optimizing your schedule. Specify --days to set the analysis window (default 90). Use --json to pipe results into dashboards or reporting scripts. Works with Google Calendar, Outlook, Exchange, Yahoo, iCloud, and IMAP providers.
Usage
nylas calendar ai analyze [--days N] [--json]Flags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --days | Number of days to analyze (default 90) |
| --apply | Apply top recommendations automatically |
| --duration | Meeting duration in minutes for scoring |
| --participants | Participants for scoring (email addresses) |
| --score-time | Score a specific meeting time (RFC3339 format) |
Examples
The nylas calendar ai analyze command studies your historical calendar data to surface meeting-acceptance patterns, actual vs scheduled durations, timezone preferences, and peak focus times, then returns AI recommendations for optimizing your schedule.
Analyze meeting patterns for the last 90 days
nylas calendar ai analyze --days 90Analyze a shorter recent window
nylas calendar ai analyze --days 30Export recommendations as JSON for a dashboard
nylas calendar ai analyze --days 90 --jsonExample output
Analyzing 90 days of calendar history... done
Meeting patterns:
• Peak acceptance: Tue-Thu, 10:00-12:00
• Avg actual duration: 27 min (scheduled 30 min)
• Most common cross-TZ pairing: America/New_York ↔ Europe/London
Recommendations:
1. Schedule focus blocks Mon/Fri afternoons (low meeting load)
2. Default 25-min meetings to match actual durationsTroubleshooting
Analysis shows 0 meetings
Check that you're authenticated with the right account. Run nylas auth whoami to verify.
Slow analysis on large calendars
Reduce the --days window. Analyzing 365 days of data can take 10-15 seconds on busy calendars.
Recommended guides
Book meeting rooms from the CLI
Book meeting rooms from the CLI by listing calendar resources, using each room email as a calendar ID, and adding it as an event participant with less setup.
Google Calendar API Sync Tokens
Use Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.
Microsoft Graph calendarView Explained
Query the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.
Microsoft Graph getSchedule Free/Busy
Call the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.
Google Workspace CLI: Limits and Alternative
What gws covers, where its OAuth scope limits and pre-1.0 status bite, and when a multi-provider email and calendar CLI is the better fit.
SavvyCal vs Nylas: Scheduling Compared
SavvyCal is a scheduling SaaS for end users. Nylas is the API and CLI for building scheduling into your product across Google, Microsoft, and iCloud calendars.
Run nylas calendar ai analyze --help for full help output.