Connectors continuously sync documents from external services into your knowledge base, so you never have to upload files manually. New content is added, changed content is re-processed, and deleted content is removed — all automatically.
Available Connectors
Sim ships with 30 built-in connectors:
| Category | Connectors |
|---|---|
| Productivity | Notion, Confluence, Asana, Linear, Jira, Google Calendar, Google Sheets |
| Cloud Storage | Google Drive, Dropbox, OneDrive, SharePoint |
| Documents | Google Docs, WordPress, Webflow |
| Development | GitHub |
| Communication | Slack, Discord, Microsoft Teams, Reddit |
| Gmail, Outlook | |
| CRM | HubSpot, Salesforce |
| Support | Intercom, ServiceNow, Zendesk |
| Data | Airtable |
| Note-taking | Evernote, Obsidian |
| Meetings | Fireflies |
Adding a Connector
From inside a knowledge base, click + New connector in the top right to open the connector picker. Select a service, then complete the setup steps:
Authenticate
Most connectors use OAuth — select an existing credential from the dropdown or click Connect new account to authorize through the service. Tokens are refreshed automatically.
A few connectors use API keys instead:
| Connector | Where to get the key |
|---|---|
| Evernote | Developer Token (starts with S=) from your Evernote account settings |
| Obsidian | Install the Local REST API plugin, then copy the key from its settings |
| Fireflies | Generate from the Integrations page in your Fireflies account |
If you rotate an API key in the external service, update it in Sim as well — OAuth tokens refresh automatically, but API keys do not.
Configure
Each connector has source-specific fields that control what gets synced. Examples:
- Notion — sync an entire workspace, a specific database, or a single page tree
- GitHub — specify a repository, branch, and optional file extension filter
- Confluence — enter your Atlassian domain and optionally filter by space key or content type
- Obsidian — provide your vault URL (
https://127.0.0.1:27124by default) and optionally restrict to a folder path - Fireflies — optionally filter by host email or cap the number of transcripts synced
Configuration is validated on save — if a repository doesn't exist or a domain is unreachable, you'll see an error immediately.
Choose sync frequency
| Frequency | Notes |
|---|---|
| Every hour | Best for fast-moving sources |
| Every 6 hours | Good balance for most sources |
| Daily (default) | Suitable for content that changes infrequently |
| Weekly | For stable, rarely-updated sources |
| Manual only | Sync only when you trigger it manually |
Sub-hourly frequencies require a Max or Enterprise plan.
Configure metadata tags (optional)
If the connector supports metadata tags, you'll see checkboxes for each available tag type (e.g., Labels, Last Modified, Notebook). All are enabled by default — uncheck any you don't need.
Tag slots are shared across all documents in a knowledge base. See Tags for details.
Connect & Sync
Click Connect & Sync to save the connector and trigger the first sync. Documents will start appearing as they're processed.
Managing Connectors
Open Connected Sources from the knowledge base to see all active connectors. Each card shows the connector's status, the last sync time and document count, and the next scheduled sync:
The action buttons on each connector card:
| Button | Action |
|---|---|
| ↻ (Refresh) | Trigger a manual sync immediately. Disabled while syncing or disabled; a 5-minute cooldown applies after each manual trigger |
| ⚙ (Settings) | Open the edit modal to change source config or sync frequency |
| ⏸ / ▶ (Pause / Resume) | Pause scheduled syncs without removing the connector. Resume works from both paused and disabled states |
| 🗑 (Delete) | Remove the connector. A confirmation modal appears with an option to also delete all synced documents |
| ∨ (Chevron) | Expand to show sync history |
Editing a Connector
Click the settings icon to open the edit modal. It has two tabs:
Settings — change any source-specific config fields (e.g., switch the GitHub branch) and update the sync frequency.
Documents — browse all documents this connector has synced and manage exclusions (see Excluding Documents below).
Sync History
Expand any connector card by clicking the chevron to see a log of recent syncs:
- Each row shows the date/time and a summary of what changed: +N (added, green), ~N (updated, amber), -N (deleted, red), !N (failed, red), or No changes
- A spinner indicates a sync currently in progress
- Error rows show a red icon and the failure message
The log retains the most recent 10 sync runs.
Excluding Documents
Sometimes a connector syncs documents you don't want in your knowledge base — drafts, templates, confidential pages, and so on. You can exclude them individually.
To exclude a document, open the connector's settings modal, go to the Documents tab, and click Exclude next to any document. Excluded documents are skipped on every subsequent sync even if the source content changes.
To reverse an exclusion, switch to the Excluded tab and click Restore — the document will be pulled in on the next sync.
How Syncing Works
On each run the connector fetches documents from the source and compares them against what's already stored. Only changed documents are reprocessed — new content is added, updated content is re-chunked and re-embedded, deleted content is removed. A connector syncing thousands of documents will only do real work when something actually changes.
Connector Status
| Status | Meaning |
|---|---|
| Active | Running normally on schedule |
| Syncing | A sync is currently in progress |
| Paused | Scheduled syncs are suspended; manual sync is still available |
| Error | The last sync failed; will retry on the next scheduled run with backoff |
| Disabled | Syncing has been paused automatically after 10 consecutive failures |
A disabled connector requires intervention — either reconnect the OAuth account or use the Resume button to re-enable syncing.
Handling Failures
If a single document fails (e.g., a permission issue or timeout), the sync continues and retries that document next time. If an entire sync fails, the connector backs off and retries with increasing delays. After 10 consecutive full-sync failures the connector is automatically set to Disabled to avoid spinning indefinitely.
Metadata Tags
Connectors can auto-populate tags with metadata from the source — for example, a Notion connector can tag documents with their Labels and Last Modified date; a GitHub connector can tag documents with Repository and File Path. These tags are then available for filtered search in the Knowledge block.
You can disable specific tag types during setup or at any time from the connector settings to free up tag slots for manual tagging or other connectors.
Tag slots are shared across all documents in a knowledge base. If multiple connectors each populate tags, they draw from the same pool of 17 slots.
Multiple Connectors
You can add as many connectors as you need to a single knowledge base. Each manages its own documents independently, and all content is searchable together through the Knowledge block. Keep tag slot usage in mind when combining connectors that each populate metadata tags.