Configure and connect integrations
Every integration follows the same pattern: configure credentials → connect → verify status.
1. Open Integrations
Open Toby.app and click Integrations in the sidebar. The Integrations window shows all available integrations and their connection status.
Click any integration to view its detail page, where you can fill in credentials, run a setup guide, connect, and check status.
2. Configure credentials
Choose a service in the Integrations window and fill in the fields on its detail page (API keys, OAuth client IDs, and so on). Each integration detail has a Setup Guide button that walks you through provider steps, shows copyable values like redirect URIs and scopes, and lets you fill credentials and connect without leaving the app.
Example: Email
Enter your IMAP and SMTP host, port, username, and password. Click Setup Guide for a step-by-step wizard.
Example: Apple Calendar
Apple Calendar needs no credentials — just click Connect and grant Calendar permission to Toby.app in System Settings when prompted.
Credentials live in ~/.toby/credentials.json (encrypted on macOS; Keychain holds the key). Connection flags live in ~/.toby/config.json.
3. Connect
Click Connect on the integration detail page. Toby validates credentials and marks the integration connected.
OAuth integrations (for example Slack) open a browser or local callback during connect. API-key integrations validate credentials and connect immediately.
4. Check status
Return to the Integrations window to see connection status at a glance. Each integration shows whether it is connected and healthy.
Disconnect
Open the integration detail page and click Disconnect. This clears Toby's connection flag — it does not delete your mail, tasks, or calendar data at the provider.
Integration guides
| Integration | Guide |
|---|---|
| Todoist | Todoist |
| Slack | Slack |
| Apple Calendar (macOS) | Apple Calendar |
| Apple Reminders (macOS) | Apple Reminders |
| Apple Contacts (macOS) | Apple Contacts |
| macOS system controls | macOS |
| Jira | Jira |
| Notion | Notion |
Web Search and Weather are built-in settings, not integrations. See Web Search and Weather.