Configure and connect integrations
Every integration follows the same pattern: configure credentials → connect → verify status.
1. Configure credentials
toby config
The configure UI has two panes:
- Left pane — expandable settings tree for AI, personas, default providers, integrations, daemon settings, and other sections.
- Right pane — details and editable fields for the selected item.
Use arrow keys to navigate, Enter to select/edit or expand/collapse, Tab to switch panes, Esc to move back, s to save, and q to quit. Toby warns before discarding unsaved edits.
Open Integrations, choose a service, and fill in the fields (API keys, OAuth client IDs, and so on). Save when done.
Credentials live in ~/.toby/credentials.json. Connection flags live in ~/.toby/config.json. You can override the directory with the TOBY_DIR environment variable.
In Toby.app on macOS, each integration detail has a Setup Guide button. The wizard walks you through provider steps, shows copyable values like redirect URIs and scopes, and lets you fill credentials and connect without leaving the app.
2. Connect
toby connect email
toby connect todoist
toby connect jira
List all integrations and whether they are connected:
toby connect
OAuth integrations (Slack, Azure AD) open a browser or local callback during connect. Email, Todoist, Jira, Web Search, and other integrations are installable plugins bundled in release archives (installed to ~/.toby/plugins/). API-key integrations validate credentials and mark the integration connected.
3. Check status
toby status
toby status integration -i email
Status shows connection health and, for some integrations, per-tool checks.
Disconnect
toby disconnect email
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 |
| Azure AD | Azure AD |
| Apple Calendar (macOS) | Apple Calendar |
| macOS system controls | macOS |
| Web Search | Web Search |
| Jira | Jira |