Overview
Trix integrates with popular productivity and automation tools to import your data as searchable memories. Connect once, sync automatically.
New: Calendar Integrations!
Connect Google Calendar, Microsoft Outlook, or Apple iCloud for AI-powered pre-meeting briefings
and intelligent reminders. Learn more →
| Integration | Direction | Features |
|---|---|---|
| Calendar (Google, Microsoft, Apple) | Import + Intelligence | AI briefings, unified view, smart notifications |
| GitHub | Import | Repositories, issues, and pull requests |
| Notion | Import | Sync pages and databases |
| Import | Gmail, Calendar, and Drive | |
| N8N | Bidirectional | Webhooks + API actions |
| Zapier | Bidirectional | Triggers + actions |
Quick Start
1. Install the CLI
# macOS/Linux (current)
brew install devghost/taps/trix
# Planned rename (ADR-144): brew install trixdb/taps/trix
# Or download from GitHub releases
curl -fsSL https://install.trixdb.com | sh2. Connect an Integration
# Connect GitHub (repositories, issues, PRs)
trix integrations connect github
# Connect Notion
trix integrations connect notion
# Connect Google (Gmail, Calendar, Drive)
trix integrations connect googleYour browser will open for OAuth authorization. After granting access, the connection is stored securely.
3. Sync Your Data
# Trigger a sync
trix integrations sync <connection-id>
# Full sync (re-imports everything)
trix integrations sync <connection-id> --full4. Search Your Imported Memories
# Search across all memories including imported content
trix search "Q1 planning notes"
# Or via API
curl -X GET "https://api.trixdb.com/v1/memories?q=Q1+planning" \
-H "Authorization: Bearer YOUR_API_KEY"Architecture
The integrations system consists of:
- OAuth Provider - Handles authentication with third-party services
- Sync Engine - Manages incremental and full sync jobs
- Content Transformer - Converts external content to Trix memories
- Webhook Handler - Receives events from automation platforms
All OAuth tokens are encrypted at rest using AES-256-GCM with account-specific keys.
Import Integrations
Import integrations pull data from external services into Trix:
- Import repositories with README
- Sync issues with labels and state
- Pull requests with branch info
- File content retrieval
- Import pages as markdown memories
- Sync database structures
- Automatic block-to-text conversion
- Incremental sync via last_edited_time
- Gmail emails with body extraction
- Calendar events with attendees
- Google Docs exported as text
- Automatic token refresh
Automation Integrations
Automation integrations enable bidirectional workflows:
- Trigger workflows on memory events
- Create/update/delete memories via API
- Custom node manifest available
- Webhook signature verification
- Polling and instant triggers
- Create, search, update actions
- Connect to 6,000+ apps
- Webhook subscription management
Environment Variables
For self-hosted deployments, configure these variables:
# Required for token encryption
INTEGRATION_ENCRYPTION_KEY=<32+ character random string>
# GitHub OAuth (from GitHub Developer Settings)
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret
# Notion OAuth (from Notion Integrations)
NOTION_CLIENT_ID=your_client_id
NOTION_CLIENT_SECRET=your_client_secret
# Google OAuth (from Google Cloud Console)
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
# Optional: N8N webhook verification
N8N_WEBHOOK_SECRET=your_webhook_secretNever commit these secrets to version control. Use environment variables or a secrets manager in production.
Next Steps
- GitHub Integration - Import repositories, issues, and PRs
- Notion Integration - Import pages and databases
- Google Integration - Sync Gmail, Calendar, Drive
- N8N Integration - Build automation workflows
- Zapier Integration - Connect to thousands of apps
- CLI Reference - Command-line integration management