Overview
Trix Calendar integrations bring your schedule into your memory layer, enabling powerful features like AI-powered pre-meeting briefings, intelligent reminders, and unified calendar views across all your accounts.
| Provider | Protocol | Key Features |
|---|---|---|
| Google Calendar | OAuth 2.0 + REST API | Real-time webhooks, multi-calendar, 60 req/min |
| Microsoft Outlook | OAuth 2.0 + Graph API | Teams integration, auto-renewal, 600 req/min |
| Apple iCloud | CalDAV + App Passwords | Privacy-focused, multi-calendar, polling sync |
Unique Feature: Pre-Meeting Briefings
Trix searches your memories for past interactions with meeting attendees and uses AI to
generate actionable context before each meeting. No other calendar app offers this!
Key Features
Pre-Meeting Briefings
Before each meeting, Trix automatically searches your memory store for:
- Past emails and conversations with attendees
- Related notes and action items
- Previous meeting outcomes
- Relevant context from other memories
AI then synthesizes this into a concise briefing, so you walk into every meeting prepared with the right context.
Multi-Provider Unified View
Connect multiple calendar accounts and see all your events in one place:
# View upcoming Google Calendar events via CLI
trix google calendar list
# API: Get unified view across all providers
curl "https://api.trixdb.com/v1/integrations/calendars/upcoming?days=7" \
-H "Authorization: Bearer YOUR_API_KEY"Intelligent Notifications
Customize when and how you get reminded about upcoming events:
- 15 minutes before - Last-minute prep
- 1 hour before - Time to review and prepare
- 1 day before - Plan your day around important meetings
- Daily digest - Morning summary of today's events
# Interactive setup wizard
trix notifications setup
# Enable specific reminder
trix notifications enable email 60 # 1 hour beforeMulti-Calendar Support
Each provider supports multiple calendars. You can selectively enable which calendars to sync:
# List Google calendars via CLI
trix google calendar list
# API: List calendars from any connection
curl "https://api.trixdb.com/v1/integrations/connections/<connection-id>/calendars" \
-H "Authorization: Bearer YOUR_API_KEY"
# API: Enable/disable specific calendars
curl -X PATCH "https://api.trixdb.com/v1/integrations/connections/<connection-id>/calendars/<calendar-id>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "sync_enabled": true }'Quick Start
1. Connect Your First Calendar
# Google Calendar via CLI (recommended for most users)
trix integrations connect google
# Microsoft Outlook (via dashboard or API)
# Visit app.trixdb.com → Settings → Integrations → Microsoft Outlook
# Apple iCloud (via dashboard or API)
# Visit app.trixdb.com → Settings → Integrations → Apple iCloud2. View Your Upcoming Events
# Show upcoming Google Calendar events via CLI
trix google calendar list
# API: Get upcoming events across all providers
curl "https://api.trixdb.com/v1/integrations/calendars/upcoming?days=7" \
-H "Authorization: Bearer YOUR_API_KEY"
# API: Get events for a specific connection
curl "https://api.trixdb.com/v1/integrations/connections/<connection-id>/events?days=30" \
-H "Authorization: Bearer YOUR_API_KEY"3. Set Up Notifications
# Run interactive wizard
trix notifications setup
# Or configure manually
trix notifications enable email 15 # 15 min before
trix notifications enable email 60 # 1 hour before
trix notifications enable email 1440 # 1 day before
# Set daily digest (8:00 AM)
trix notifications digest "08:00"Security & Privacy
Token Encryption
All OAuth tokens are encrypted at rest using AES-256-GCM with account-specific keys:
- Tokens never stored in plaintext
- 256-bit encryption keys
- Account isolation (tokens can't be used across accounts)
- Automatic token refresh for expired credentials
OAuth 2.0 with PKCE
Google and Microsoft connections use OAuth 2.0 with Proof Key for Code Exchange (PKCE) to prevent authorization code interception attacks.
Apple App-Specific Passwords
Apple iCloud uses app-specific passwords, which can be revoked at any time from your Apple ID settings without affecting your main password.
Trix only requests the minimum scopes necessary: read-only access to calendar events. We never request write access unless you explicitly enable two-way sync.
Provider Comparison
| Feature | Microsoft | Apple | |
|---|---|---|---|
| Real-time sync | Webhooks | Webhooks | 15-min polling |
| Multi-calendar | Yes | Yes | Yes |
| Rate limit | 60 req/min | 600 req/min | ~30 req/min |
| Setup complexity | Easy | Easy-Medium | Medium |
| OAuth flow | Automatic | Automatic | Manual password |
| Tenant support | N/A | Multi-tenant | N/A |
Which Provider Should I Use?
- Google Calendar - Best for most users. Easy setup, real-time updates, excellent reliability.
- Microsoft Outlook - Best for Office 365 users. Teams integration, enterprise features.
- Apple iCloud - Best for Apple ecosystem users. Privacy-focused, works across all Apple devices.
You can connect multiple providers at once! Connect your work Outlook, personal Google Calendar, and family iCloud calendar for a complete unified view.
API Reference
List Upcoming Events
# Get upcoming events from all calendars
GET /v1/integrations/calendars/upcoming?days=7
# Response
{
"events": [
{
"id": "event-123",
"title": "Team standup",
"start": "2026-01-13T10:00:00Z",
"end": "2026-01-13T10:30:00Z",
"provider": "google",
"calendar_id": "primary",
"attendees": ["[email protected]", "[email protected]"],
"location": "Conference Room A",
"description": "Daily sync meeting"
}
],
"total": 15
}List Calendars
# Get calendars from a specific connection
GET /v1/integrations/connections/{connection_id}/calendars
# Response
{
"calendars": [
{
"id": "primary",
"name": "Work Calendar",
"sync_enabled": true,
"color": "#42a5f5"
},
{
"id": "family-abc123",
"name": "Family",
"sync_enabled": false,
"color": "#4caf50"
}
]
}Configure Notification Preferences
# Create a notification preference
POST /v1/integrations/notifications/preferences
Content-Type: application/json
{
"notification_type": "email",
"time_offset_minutes": 60,
"enabled": true
}
# Response
{
"id": "pref-abc123",
"notification_type": "email",
"time_offset_minutes": 60,
"enabled": true,
"created_at": "2026-01-12T10:00:00Z"
}Troubleshooting
Connection Failed
Symptom: OAuth flow fails or connection can't be established
Solutions:
- Ensure you're using the correct email address for the provider
- Check that popups aren't blocked in your browser
- For Microsoft: Verify tenant selection (common/consumers/custom)
- For Apple: Generate a fresh app-specific password
Events Not Syncing
Symptom: Calendar events aren't showing up in Trix
Solutions:
- Check connection status:
trix integrations status <connection-id> - Verify calendar is enabled via the API or dashboard
- Trigger manual sync:
trix integrations sync <connection-id> - For Apple: Wait 15 minutes for polling interval
Notifications Not Arriving
Symptom: Not receiving email reminders for events
Solutions:
- Verify preferences:
trix notifications list - Check spam/junk folder for emails from [email protected]
- Ensure notification is enabled:
enabled: true - Check that events are in the future (no notifications for past events)
Get Help
# Built-in troubleshooting for each provider
trix integrations troubleshoot google
trix integrations troubleshoot microsoft
trix integrations troubleshoot appleNext Steps
- Google Calendar Setup - Connect Google Calendar with OAuth
- Microsoft Outlook Setup - Connect Outlook with tenant selection
- Apple iCloud Setup - Connect iCloud with app-specific password
- CLI Reference - Complete command-line integration guide
- API Reference - Full REST API documentation