Command
nylas calendar ai conflicts check
Check a proposed meeting for scheduling conflicts with AI analysis.
Written by Qasim Muhammad Staff SRE
What does nylas calendar ai conflicts check do?
The nylas calendar ai conflicts check command evaluates a proposed meeting against your existing calendar and uses AI to detect hard conflicts (overlapping events) and soft conflicts (back-to-back meetings, focus-time interruptions), then scores alternative times. Pass --title and --start (both required); set --duration in minutes and --participants to refine the check, or --auto-resolve to pick the best alternative. Works with Google Calendar, Outlook, Exchange, Yahoo, iCloud, and IMAP providers.
Usage
nylas calendar ai conflicts check --title TITLE --start RFC3339 [--duration MIN] [--participants EMAILS]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 |
| --title | Meeting title (required) |
| --start | Start time in RFC3339 format (required) |
| --duration | Duration in minutes (default 60) |
| --participants | Participant email addresses (comma-separated) |
| --auto-resolve | Automatically select the best alternative |
| --end | End time in RFC3339 format (optional, uses --duration if not set) |
Examples
The nylas calendar ai conflicts check command evaluates a proposed meeting against your existing calendar and uses AI to detect hard conflicts (overlapping events) and soft conflicts (back-to-back meetings, focus-time interruptions), then scores alternative times.
Check a proposed meeting for conflicts
nylas calendar ai conflicts check --title "Product Review" --start "2026-06-23T14:00:00Z" --duration 60Check against specific participants
nylas calendar ai conflicts check --title "Team Sync" --start "2026-06-23T10:00:00Z" --participants team@company.comCheck and auto-select the best alternative
nylas calendar ai conflicts check --title "1:1" --start "2026-06-23T16:00:00Z" --auto-resolveExample output
Checking conflicts for "Sprint review"
Proposed: 2026-07-01T14:00:00Z - 2026-07-01T15:00:00Z (60 min)
⚠ 1 conflict found:
• 14:30-15:00 1:1 with alice (evt_def456)
Suggested alternatives:
1. 2026-07-01T15:30:00Z (no conflicts)
2. 2026-07-01T16:30:00Z (no conflicts)Troubleshooting
No conflicts detected when there are overlapping events
Ensure you're authenticated with the correct grant. Run nylas auth whoami to verify the active account.
AI analysis returns an error
Check your network connection. The AI conflict detection requires an API call to analyze event patterns.
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 conflicts check --help for full help output.