Integrations & connections settings
Settings reference for which outside services the app connects to and how it behaves when it does, covering email, file storage, calendars, messaging, project tools and automation bridges.
On this page
- Gmail integration
- Auto-focus reply box
- Gmail compose uses the new shared editor
- Recolour emails in dark mode
- Auto-mark as read
- Threads per page
- Google CLI backend
- Auto-import pasted Google Doc URLs
- Google Drive integration
- Dropbox integration
- OneDrive integration
- Google Sheets integration
- SMS integration
- SMS provider
- AI name inference daily cost cap
- Calendar integration
- Notion auto-sync
- Notion inbox notifications
- Show images in Notion pages
- Jira inbox notifications
- Linear inbox notifications
- Canva integration
- Fathom integration
- Zapier integration
- Webhooks
- Supermail inbox notifications
- Pull request inbox notifications
- PR merge-queue dry-run mode
- PR-prep prompt (advanced)
- Custom rules for the PR-prep prompt
- Merge prompt (advanced)
- PR body check
- Block remote images in emails
- Classic Email Cleanup layout
- Slack integration
- RSS integration
- Telegram integration
- Teams chats
- Sending Teams messages
- Teams channels
- Show Teams messages in my inbox
- Alert me about new Teams messages
- Allow importing Teams history
Controls which outside services Omniscio connects to and how it behaves when it does — email, file storage, calendars, messaging, project tools, and automation bridges.
Gmail integration
Turns the Gmail panel on or off in the sidebar. When enabled, you can read email threads, reply, archive, star, and snooze without leaving Omniscio. Requires your Google account to be connected. Off by default until you sign in. Disabling it hides the panel but does not disconnect your Google account — re-enable at any time to get the inbox back. Related settings: gmailPageSize, gmailAutoMarkRead, gmailAutoFocusReply.
Auto-focus reply box
Controls where keyboard focus lands when you open an email. When on, the cursor jumps straight into the reply text box so you can start typing immediately. When off (the default), focus stays on the message body, which keeps all triage keyboard shortcuts active: E to archive, S to star, U to mark unread, ! for spam, X to select, H to snooze. Press R when you're ready to reply. Turn this on if you rarely use keyboard shortcuts and prefer to reply by default.
Gmail compose uses the new shared editor
Puts the Gmail compose window and the inline reply box on the same editor the other writing boxes use, so lists behave the way people expect: Tab nests an item and Shift+Tab un-nests it, Enter continues a list, and Enter on an empty bullet steps back one level. On by default. Your send shortcut does not change — Ctrl/Cmd+Enter sends, and a plain Enter never sends an email; it is a new line, or list work when the caret is on a list line. A list you type arrives in the recipient's mail as a real bulleted or numbered list. Turn this off to go back to the plain text box, live, with no restart.
Recolour emails in dark mode
A new way for the Gmail panel to show designed emails in dark mode. Instead of inverting the whole email, it recolours backgrounds and text, keeps photos and brand colours as they are, uses the sender's own dark design when the email has one, and keeps logos readable. Off by default, so dark mode works exactly as it does today until you turn this on. "Show in light" still shows any email in its original light design, and turning this off goes straight back to the current dark mode.
Auto-mark as read
When on, Omniscio automatically marks an email thread as read the moment you open it — the same behavior Gmail itself uses. When off, threads stay unread until you mark them manually, which is useful if you want to come back to something later. On by default, so opening an email does mark it read unless you turn this off.
Threads per page
Sets how many email threads load at one time in the Gmail panel. Accepts whole numbers from 1 to 100 (the UI enforces 10–100 in steps of 10). A smaller number loads faster; a larger number means less scrolling to reach older threads. The default is 20. Adjust it if you would rather load fewer or more threads in one sitting.
Google CLI backend
Chooses which command-line tool Omniscio uses to talk to Gmail and Google Calendar. gog is the default — it's already installed and signed in on this machine. gws is Google's official Workspace CLI (a Rust binary from github.com/googleworkspace/cli); it needs to be installed separately and requires its own gws auth login before you switch. Both backends do the same job — switch to gws only if you have a reason to prefer it or if gog stops working.
Auto-import pasted Google Doc URLs
When on, pasting a Google Docs or Google Slides link into a chat session automatically fetches the document's text content and inserts it inline, so the session can work with the actual content rather than just a URL. Hold Shift while pasting to skip the fetch for that paste. Off by default; turn it on if you want pasted Doc links expanded into their content automatically. Nothing turns it on when you connect Google Drive.
Google Drive integration
Adds a Google Drive panel to the sidebar for browsing folders, opening files, and uploading documents without leaving Omniscio. Requires your Google account to be connected. Turn off to hide the Drive panel; your Google sign-in is unaffected and the panel can be re-enabled later. Off by default until you connect Google.
Dropbox integration
Adds a Dropbox panel to the sidebar so you can browse folders, open files, and upload documents from your Dropbox account directly in Omniscio. Requires a connected Dropbox account. Off by default. Disabling hides the panel but does not sign you out of Dropbox.
OneDrive integration
Adds a Microsoft OneDrive panel to the sidebar for browsing, opening, and uploading files from your OneDrive storage. Requires your Microsoft account to be connected. Off by default. Turning this off hides the panel; your Microsoft sign-in persists and you can re-enable it at any time.
Google Sheets integration
Adds a Sheets panel to the sidebar so you can browse and edit Google Sheets spreadsheets without leaving Omniscio. Requires your Google account to be connected. Off by default. Disabling hides the panel; your Google sign-in is unaffected.
SMS integration
Turns SMS messaging on or off. When enabled, Omniscio can send and receive text messages through your chosen SMS provider (Pushbullet or a self-hosted native gateway). Off by default. Requires a Pushbullet account or a running native gateway app on your phone before enabling. Related: smsProvider, smsNameInferCostCapUsdPerDay.
SMS provider
Selects the backend used to send and receive texts. Pushbullet routes messages through Pushbullet's cloud service — easy to set up but requires a Pushbullet account. Native (my phone) sends over your own phone's real SIM via a self-hosted gateway app, with no third-party cloud in the path. Only visible when SMS is enabled. Default is pushbullet. Switch to native if you want full control over your messages and don't want them passing through a third-party server.
AI name inference daily cost cap
Limits how much Omniscio spends per calendar day on AI calls (via Claude Haiku) that figure out friendly names for unknown short codes — for example, turning 62438 into "eBay security code". Once the daily cap is reached, name inference pauses until midnight and resumes the next day. Accepted range is $0.05 to $5.00. Default is a low value to keep costs predictable. Raise it if you receive many messages from short codes and want them named promptly. Only visible when SMS is enabled.
Calendar integration
Shows upcoming calendar events in the sidebar and sends reminders before meetings. Connects to Google Calendar (requires your Google account). When on, you can see your day's agenda and get notified before an event starts without switching to another app. Off by default until you connect Google. Disable to hide the calendar panel while keeping your Google account connected.
Notion auto-sync
Keeps the currently open Notion page refreshed automatically while the Notion board is visible and Omniscio is in the foreground. When on, Omniscio re-checks the open page for edits in the background and periodically refreshes the view, pausing when the window is hidden. On by default. Turn off if you prefer to refresh manually with the refresh button, or if background network activity is a concern.
Notion inbox notifications
Surfaces recently-edited Notion pages as rows in the unified Inbox and adds a new row when a page changes, so you see Notion activity without switching apps. Requires the Notion board to be enabled and connected. Off by default. When on, Omniscio checks Notion in the background every few minutes. Disable to stop Notion items from appearing in the Inbox while keeping the Notion board itself active.
Show images in Notion pages
Controls whether image blocks load when you open a Notion page inside Omniscio. Off by default for privacy — loading external images can reveal your IP address and that you viewed the content, similar to email tracking pixels. While off, an image block shows a placeholder with a link to open the page in Notion directly. Turn on if you want inline images to display and are comfortable with the privacy trade-off.
Jira inbox notifications
Surfaces your assigned, not-yet-done Jira issues as rows in the unified Inbox and adds a row whenever one of them updates. Requires the Jira board (above) to be enabled and your Jira account connected. Off by default. When on, Omniscio polls Jira in the background every few minutes. Disable to stop Jira items from appearing in the Inbox without disconnecting Jira entirely.
Linear inbox notifications
Surfaces your unread Linear notifications — mentions, replies, status changes, and new assignments — as rows in the unified Inbox. Requires the Linear board to be enabled and connected. Off by default. When on, Omniscio checks Linear in the background every few minutes. Disable to stop Linear notifications from appearing in the Inbox while keeping the Linear board active.
Canva integration
Connects your Claude sessions to Canva via an MCP (Model Context Protocol) bridge. When on, sessions can create and edit designs, search your Canva library, export to various formats, and manage brand assets — all through conversation. Requires your Canva account to be linked. Off by default. Disable to disconnect the Canva bridge without affecting your Canva account.
Fathom integration
Retired (2026-09-19). No Omniscio-built MCP server composes into a session any more, so the Fathom MCP connection and its toggle and API key are gone. The server code and its entry builder stay in the tree, unwired.
Zapier integration
Connects your Claude sessions to thousands of apps through Zapier's MCP server. When on, sessions can trigger Zaps, pass data between apps, and run automations across the 8,000+ services Zapier supports. To set up: create a Zapier MCP server at mcp.zapier.app, then paste the server URL into the field that appears below. Off by default. Disable to disconnect the Zapier bridge without removing your Zapier account.
Webhooks
Lets external services send data into Omniscio by posting to a unique webhook URL you give them. Useful for CI/CD pipelines, monitoring tools, custom scripts, or any service that can make an HTTP POST request. When on, Omniscio listens for incoming webhook payloads and routes them to sessions or inbox rows. Off by default. Enable when you want to trigger Omniscio actions from an outside system.
Supermail inbox notifications
Controls whether unread emails from the Supermail plugin appear as rows in the unified Inbox. When on, Supermail emails surface alongside your other inbox items so you can triage them in one place. Requires the Supermail plugin to be active. Off by default. Disable to stop Supermail items from appearing in the Inbox without removing the plugin.
Pull request inbox notifications
Turns on a background check of the GitHub pull requests that are waiting on you — reviews you have been asked to do, and your own pull requests that have changes requested. Requires the GitHub CLI (gh) to be installed and signed in. Off by default. While it is on, Omniscio asks GitHub every few minutes; turn it off to stop those background checks.
PR merge-queue dry-run mode
When on, the PR merge-queue daemon logs what it would auto-merge on each tick but does not actually spawn any Claude sessions or trigger merges. Use it to preview which pull requests the daemon would pick up and in what order, with nothing started and nothing spent. Off by default. It only changes what the daemon does on a tick — it does not turn the daemon on.
PR-prep prompt (advanced)
The instructions Omniscio gives each session it starts to get one of your pull requests ready to merge. Leave it empty to use the built-in version — the default is written for the job and most people never change it. If you write your own, it must keep four things, or Omniscio ignores it and uses the built-in prompt instead: the {{pr_number}} placeholder, the /ready-to-merge hand-off that marks a branch ready, the [PR-MERGE | PR #{{pr_number}} | READY-TO-MERGE] line that signals the run succeeded, and the rule that never pushes to your main branch (do NOT land on master, push, or merge). The box warns you as you type and names anything missing, so an override that will be ignored is flagged rather than silently dropped. There is an easier option — Your custom rules, the box above the prompt box on the same card — that adds your own instructions without you having to preserve any of that. Edit both in Settings → PR Merge Queue, on the PR-Prep Prompt tab.
Custom rules for the PR-prep prompt
Standing rules appended to the automatic PR-prep prompt — the easy way to add your own instructions without rewriting the whole prompt and having to keep its load-bearing lines intact. Whatever you put here is added on top of the built-in preparation prompt, or on top of your own prompt if you have set one above. Edit it in Settings → PR Merge Queue.
Merge prompt (advanced)
The instructions Omniscio gives the session that merges one of your pull requests, in place of the built-in version. Leave it empty to use the built-in prompt. A per-repo override takes precedence over this global one, so set this only when every repo should behave the same way. A custom prompt replaces the built-in one only if it keeps four things: the {{reviewed_head_oid}} placeholder (the immutable-head check), and the sentences Do NOT touch the base branch in ANY way, Do NOT push anything to any remote and Do NOT force-push. One missing piece and the prompt is skipped — the built-in is used instead and only a log warning records it at merge time. The box warns you as you type and names anything missing. Edit it in Settings → PR Merge Queue.
PR body check
On by default in an Omniscio source checkout, and off in a packaged install. Every ten minutes Omniscio reads the open pull requests you authored in the repositories registered here as projects, and checks each description against its own pull-request standard — the Real delta block. It wants a ## Real delta heading, the measured merge base the change was read from, your own file count and line delta, the names of the files you changed, and any commits in the diff that are not yours. Those own numbers have to be measured from the branch's fork point rather than its tip: once your work has already landed on the branch's base, a tip measurement reads as nothing, so Omniscio recovers the fork point or refuses to report instead of printing a zero you cannot check. A body with no such heading is always reported, and Omniscio does not check whether the repository has adopted the standard at all.
A short body is told to its owner first: Omniscio messages the agent session that owns the branch, which is a billed turn. It sends at most two messages about one pull request in a run of the app, so it cannot nag — but restarting the app starts that count again, and a body left unfixed can be raised once more. With no session on that branch it raises an Inbox card instead, naming the two commands that fix the body: where the pull request lives in the Omniscio checkout itself, the pr:body tool, which writes the block, then gh pr edit on the file it writes; for a pull request in any other repository, the same generator called by its full path, which writes the finished body to a temporary file outside that repository — and only once it has been able to measure the branch, so a run that fails leaves nothing that could overwrite the existing description — then gh pr edit on that file. A repository that has never heard of the standard is still reported on every pull request. Drafts are skipped, and so is anything last updated more than seven days ago. Requires the GitHub CLI (gh) to be installed and signed in.
To stop the checks, turn off prBodyCheckEnabled; this check has no on-screen switch of its own.
Block remote images in emails
Prevents external images from loading when you open an email in Omniscio's Gmail panel. Remote images can silently notify the sender that you opened the message and report your IP address — a technique often called a "tracking pixel." Blocking them keeps that information private. Inline images and attachments (images already embedded in the email) still display normally. Off by default. Turn on for stronger email privacy.
Classic Email Cleanup layout
Switches the Email Cleanup tool back to its original flat sender list instead of the AI-guided walkthrough. The AI-guided walkthrough is the default — it steps you through senders one by one with suggested actions. Turn this on if you prefer a simple list view where you decide what to do for each sender yourself, without the guided flow. The underlying cleanup actions are the same either way.
Slack integration
Turns the Slack integration on or off. When enabled, Omniscio can connect to your Slack workspace so sessions and inbox items can surface Slack activity. Requires your Slack account to be connected. Off by default until you sign in. Disable to disconnect the integration without removing your Slack account.
RSS integration
Turns the RSS/Atom feed reader on or off. When enabled, you can subscribe to feeds and have new articles surface in the sidebar and optionally in the Inbox. Off by default. Enable and add feed URLs in the RSS settings to start receiving articles. Disable to hide the reader without losing your saved feed subscriptions.
Telegram integration
Turns Telegram messaging on or off in Omniscio. When enabled, Omniscio connects to your Telegram account via the MTProto protocol so you can send and receive Telegram messages from within the app. Requires your Telegram phone number and a sign-in confirmation code. Off by default. Disable to disconnect Telegram while keeping your account intact; re-enable to sign back in.
Teams chats
Controls whether Omniscio checks for and shows your Microsoft Teams chats. It is one of six switches in Settings > Channels > Microsoft Teams, a card that appears once the early-access Microsoft Teams feature is turned on in Settings > Lab. Chats also need a work or school Microsoft account, and you must press Allow on the Chats row in that card first. When this is on, Omniscio checks for new chat messages about once a minute (up to 30 recent chats each time). When you turn it off, Omniscio stops checking chats, hides them from the inbox, and refuses to send into them. Channels are not affected. On by default.
Sending Teams messages
Allows you to reply to Teams chats and channels from Omniscio. Nothing is ever sent unless you press Send yourself, and the message box always shows who it goes to. If Teams gives an unclear answer, Omniscio tells you the message may not have been sent so you can check Teams, and it does not retry. When you turn this off, reading still works but Send is refused with a note that sending is turned off in Settings. It sits in Settings > Channels > Microsoft Teams, which appears once the early-access Microsoft Teams feature is on in Settings > Lab. On by default.
Teams channels
Controls whether Omniscio checks for and shows messages in your Microsoft Teams team channels. It needs a work or school Microsoft account, and you must press Allow on the Channels row in Settings > Channels > Microsoft Teams first. Many companies need an IT admin to approve channel access, and that card gives you a link to send them. When this is on, Omniscio checks about once a minute, covering up to 20 of your channels. When you turn it off, channels stop updating, disappear from the inbox, and sending into them is refused. Chats are not affected. On by default.
Show Teams messages in my inbox
Makes new Teams messages appear as rows in your Omniscio inbox, the same way Slack messages do. Messages are picked up by a check that runs about once a minute, so they are not instant. Only messages that arrive after a chat or channel has first been loaded show up as new rows. The Teams chats and Teams channels switches still decide which of the two are checked at all. When you turn this off, Teams messages no longer appear in the inbox, but you can still read them in the Microsoft Teams panel. Found in Settings > Channels > Microsoft Teams. On by default.
Alert me about new Teams messages
Raises an alert when a new Teams message arrives. The alert names the sender and the chat or channel, for example "New Teams message from Sam", and never includes the message text. The alert clears when you mark that chat as read. This works separately from the inbox switch, so you can get alerts without inbox rows, or the other way around. Only messages that arrive after a chat or channel has first been loaded raise an alert. Found in Settings > Channels > Microsoft Teams. On by default.
Allow importing Teams history
Lets you copy past Teams chats and channels into a Team Chat workspace. When this is on, and you have allowed Teams chats or channels, an "Import Teams history..." button appears in Settings > Channels > Microsoft Teams. You choose which conversations to bring in, and Omniscio copies up to the last year of messages into the Team Chat workspace you have open. Teams is only read, never changed, and stopping an import keeps whatever has already arrived. You must be signed in to Team Chat for it to run. When you turn this off, the button is hidden and imports are refused. On by default.