The Connectors window is where you choose which of your accounts Haruno may use. You sign in here, switch each connector on or off, and sign out.
Open it
Click your account
Your account is at the bottom of the sidebar. Click it.
Choose Connectors…
The window opens. There is only one, so if it is already open it comes to the front.
You can leave the window open beside a chat while you set something up.
What is in the list
Section What is in it Google Gmail, Google Calendar and Google Drive Cloud storage OneDrive, SharePoint and Dropbox Communication Slack and Discord Built-in tools Office Tools Custom MCP servers Servers you add yourself. Advanced view only
Each connector has its own page.
Some tools have no row because they need no setup. Web search , reading files and the file preview are always on. There is no switch to take them away.
What a row shows
Each row has a name, one line about its state, and a control on the right.
Before you connect, the line says what the connector does. The control is Sign in or Connect .
After you connect, the line shows your account. The control is a switch and a ⋯ menu.
Connect a connector
Gmail, Google Calendar and Slack sign in through your browser.
Click Sign in
Each Google connector has its own sign in. Signing in to Gmail does not sign in Google Calendar.
Finish in your browser
The row says Finish signing in in your browser… and shows Cancel . Choose the account and approve.
Come back to Haruno
The row shows your account. The connector is on.
Discord asks for a bot token instead. The cloud drives start with Connect and then ask which folders to share. Each page above has the steps.
The switch and the ⋯ menu
The switch turns a connector on or off. When it is off, Haruno does not use the connector. Your sign in stays.
The ⋯ menu depends on the connector.
Connector Menu items Gmail, Google Calendar Sign in again , Sign out Slack Sign out Discord Change bot or channel , Disconnect Cloud drives See Cloud storage Custom servers Edit… , Remove
Signing out removes the sign in from this Mac. For Google and Slack, Haruno also asks the service to end its access, when it can.
Haruno asks before it acts
Once Gmail, Google Calendar, Slack or Discord is connected and on, a switch under its row starts with Require confirmation before… . It is on until you turn it off. It names the actions Haruno will ask about first: sending, replying and deleting for Gmail, changing events for Google Calendar, posting for Discord, and posting and writing for Slack.
Permission modes are explained on Permissions and approvals .
When a row shows a warning
The row says What to do Credential rejected — sign in again to reconnect. The service refused the saved sign in. Open the ⋯ menu and choose Sign in again Credential missing — sign in again to reconnect. The saved sign in is gone from this Mac. Sign in again Unlock your keychain to reconnect. Your Mac's keychain is locked. Unlock it and the row clears
While Haruno's isolated space is still being prepared after an install or update, a line at the bottom of the window says so. Connectors work once it is ready.
Where connectors work
Connectors work in a chat that is in no project
A chat that belongs to a project does not use Gmail, Google Calendar, Discord, Slack, servers you added yourself or the cloud storage tools. It keeps web search and reading files. The chat that Ask Haruno opens on a company's page has that company's books and no connectors or web search. A chat that needs your accounts should be in no project. See Chats in a project .
Scheduled tasks
A scheduled task never uses Slack or a server you added yourself. Mail, calendar invitations with guests, Discord posts and cloud folder changes that would reach other people are held in Waiting until you approve them. Each connector's page says what is held. See Scheduled tasks and The Waiting queue .
Settings that touch connectors
Settings ▸ General ▸ Advanced view shows the Custom MCP servers section in this window. See Normal view and advanced view .Settings ▸ General ▸ Delete local data… removes every connector sign in on this Mac, along with everything else Haruno keeps there.
Not in this window
QuickBooks. It is not a connector. You connect a company on the dashboard's QuickBooks page, and Haruno reads it through the books. See QuickBooks sync .LinkedIn, Git and Local folder. The Mac no longer offers them. If you had one connected, Haruno signs you out of it when the app starts.Outlook, Notion and Telegram. They are not on the Mac.
Who has it
Everyone, in the normal view and the advanced view. The Custom MCP servers section is in the advanced view only. Slack needs you to be signed in to Haruno first.
What to tell a customer
Open Connectors… from your account at the bottom of the sidebar, sign in to the accounts you want Haruno to use, and leave the confirmation switches on. Haruno asks before it sends or posts. Scheduled tasks hold anything that reaches other people for your approval.
Last updated 8 Nov 2026 · PR #2944 · View this version on GitHub
History (1 version) 8 Nov 2026 Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
What changed @@ -0,0 +1,134 @@
+---
+title: The Connectors window
+summary: One window where you connect Haruno to Gmail, Google Calendar, cloud storage, Slack and Discord, and switch each one on or off.
+feature: connectors
+covers:
+ - apple/Sources/ConnectorsFeature/**
+ - apple/Sources/HarunoShell/SidebarAccountRow.swift
+ - apple/Sources/HarunoShell/SessionSnapshotBuilder.swift
+ - apple/Sources/EngineSupport/EngineEnvironmentAssembly.swift
+ - Integrations/retired.json
+---
+
+The Connectors window is where you choose which of your accounts Haruno may use. You sign in here, switch each connector on or off, and sign out.
+
+## Open it
+
+<Steps>
+<Step title="Click your account">
+Your account is at the bottom of the sidebar. Click it.
+</Step>
+<Step title="Choose Connectors…">
+The window opens. There is only one, so if it is already open it comes to the front.
+</Step>
+</Steps>
+
+You can leave the window open beside a chat while you set something up.
+
+## What is in the list
+
+| Section | What is in it |
+|---|---|
+| <Ui>Google</Ui> | Gmail, Google Calendar and Google Drive |
+| <Ui>Cloud storage</Ui> | OneDrive, SharePoint and Dropbox |
+| <Ui>Communication</Ui> | Slack and Discord |
+| <Ui>Built-in tools</Ui> | Office Tools |
+| <Ui>Custom MCP servers</Ui> | Servers you add yourself. Advanced view only |
+
+Each connector has its own page.
+
+- [Gmail and Google Calendar](/macos/connectors/mail-and-calendar/)
+- [Google Drive, OneDrive, SharePoint and Dropbox](/macos/connectors/google-drive-and-cloud-storage/)
+- [Slack](/macos/connectors/slack/)
+- [Discord](/macos/connectors/discord/)
+- [Office Tools, file reading and preview](/macos/connectors/office-and-files/)
+- [Custom MCP servers](/macos/connectors/custom-servers/)
+
+Some tools have no row because they need no setup. [Web search](/macos/connectors/web-search/), reading files and the file preview are always on. There is no switch to take them away.
+
+## What a row shows
+
+Each row has a name, one line about its state, and a control on the right.
+
+Before you connect, the line says what the connector does. The control is <Ui>Sign in</Ui> or <Ui>Connect</Ui>.
+
+After you connect, the line shows your account. The control is a switch and a ⋯ menu.
+
+## Connect a connector
+
+Gmail, Google Calendar and Slack sign in through your browser.
+
+<Steps>
+<Step title="Click Sign in">
+Each Google connector has its own sign in. Signing in to Gmail does not sign in Google Calendar.
+</Step>
+<Step title="Finish in your browser">
+The row says <Ui>Finish signing in in your browser…</Ui> and shows <Ui>Cancel</Ui>. Choose the account and approve.
+</Step>
+<Step title="Come back to Haruno">
+The row shows your account. The connector is on.
+</Step>
+</Steps>
+
+Discord asks for a bot token instead. The cloud drives start with <Ui>Connect</Ui> and then ask which folders to share. Each page above has the steps.
+
+## The switch and the ⋯ menu
+
+The switch turns a connector on or off. When it is off, Haruno does not use the connector. Your sign in stays.
+
+The ⋯ menu depends on the connector.
+
+| Connector | Menu items |
+|---|---|
+| Gmail, Google Calendar | <Ui>Sign in again</Ui>, <Ui>Sign out</Ui> |
+| Slack | <Ui>Sign out</Ui> |
+| Discord | <Ui>Change bot or channel</Ui>, <Ui>Disconnect</Ui> |
+| Cloud drives | See [Cloud storage](/macos/connectors/google-drive-and-cloud-storage/) |
+| Custom servers | <Ui>Edit…</Ui>, <Ui>Remove</Ui> |
+
+Signing out removes the sign in from this Mac. For Google and Slack, Haruno also asks the service to end its access, when it can.
+
+## Haruno asks before it acts
+
+Once Gmail, Google Calendar, Slack or Discord is connected and on, a switch under its row starts with <Ui>Require confirmation before…</Ui>. It is on until you turn it off. It names the actions Haruno will ask about first: sending, replying and deleting for Gmail, changing events for Google Calendar, posting for Discord, and posting and writing for Slack.
+
+Permission modes are explained on [Permissions and approvals](/macos/safety/permissions/).
+
+## When a row shows a warning
+
+| The row says | What to do |
+|---|---|
+| <Ui>Credential rejected — sign in again to reconnect.</Ui> | The service refused the saved sign in. Open the ⋯ menu and choose <Ui>Sign in again</Ui> |
+| <Ui>Credential missing — sign in again to reconnect.</Ui> | The saved sign in is gone from this Mac. Sign in again |
+| <Ui>Unlock your keychain to reconnect.</Ui> | Your Mac's keychain is locked. Unlock it and the row clears |
+
+While Haruno's isolated space is still being prepared after an install or update, a line at the bottom of the window says so. Connectors work once it is ready.
+
+## Where connectors work
+
+<Callout variant="warning" title="Connectors work in a chat that is in no project">
+A chat that belongs to a project does not use Gmail, Google Calendar, Discord, Slack, servers you added yourself or the cloud storage tools. It keeps web search and reading files. The chat that Ask Haruno opens on a company's page has that company's books and no connectors or web search. A chat that needs your accounts should be in no project. See [Chats in a project](/macos/chat/project-chats/).
+</Callout>
+
+<Callout variant="info" title="Scheduled tasks">
+A scheduled task never uses Slack or a server you added yourself. Mail, calendar invitations with guests, Discord posts and cloud folder changes that would reach other people are held in Waiting until you approve them. Each connector's page says what is held. See [Scheduled tasks](/macos/automation/scheduled-tasks/) and [The Waiting queue](/macos/automation/waiting-queue/).
+</Callout>
+
+## Settings that touch connectors
+
+- <Ui>Settings ▸ General ▸ Advanced view</Ui> shows the <Ui>Custom MCP servers</Ui> section in this window. See [Normal view and advanced view](/macos/app/normal-and-advanced-view/).
+- <Ui>Settings ▸ General ▸ Delete local data…</Ui> removes every connector sign in on this Mac, along with everything else Haruno keeps there.
+
+## Not in this window
+
+- **QuickBooks.** It is not a connector. You connect a company on the dashboard's QuickBooks page, and Haruno reads it through the books. See [QuickBooks sync](/macos/books/quickbooks-sync/).
+- **LinkedIn, Git and Local folder.** The Mac no longer offers them. If you had one connected, Haruno signs you out of it when the app starts.
+- **Outlook, Notion and Telegram.** They are not on the Mac.
+
+## Who has it
+
+Everyone, in the normal view and the advanced view. The <Ui>Custom MCP servers</Ui> section is in the advanced view only. Slack needs you to be signed in to Haruno first.
+
+## What to tell a customer
+
+Open <Ui>Connectors…</Ui> from your account at the bottom of the sidebar, sign in to the accounts you want Haruno to use, and leave the confirmation switches on. Haruno asks before it sends or posts. Scheduled tasks hold anything that reaches other people for your approval.