Connectors

What each connector lets Haruno do in a chat or a scheduled task, how to connect and disconnect one, and why the month-end close never needs one.

What connectors do, and what they are not for

A connector lets Haruno use one of your accounts or tools in a chat or a scheduled task: send an email, add a calendar event, work in a shared folder, post to your team's channel. Connectors are optional, and none of them is part of the month-end close.

The close reads only the exports you add to each company, or the months Sync brings in from QuickBooks, and keeps a fingerprinted copy of every file it posts, so a closed month rests on files you can show an auditor. A live connection changes every time someone posts a late bill or a reclassification, so it cannot be that evidence. See Adding files to a company.

You want toUse
Ask a company for its month-end exports by emailGmail, with any Google sign-in
Find a company's exports in your mail and save the attachmentsGmail, through your organization's Google app
Work with files in cloud storage or a SharePoint libraryGoogle Drive, OneDrive, SharePoint or Dropbox
Block time for the close, or check your calendarGoogle Calendar
Post a close update to your teamSlack in a chat, or Discord through a bot you create
Build a schedule in Excel, a memo in Word or a board deck in PowerPointOffice Tools. Microsoft Office is not required.
Look up a standard, a rate or a filing deadlineWeb search, always on while you are signed in
Ask about a company's QuickBooks figuresNo connector. Add the company in the Portfolio (Add company ▸ From QuickBooks), then ask in a chat: Haruno answers from the company's books.
Work with Outlook mail or an Outlook calendarThe Windows app only
Bring in figures from a bank, payroll, Stripe or HubSpotNo connector. Add Stripe invoice and HubSpot deal exports like any other export.

Exports from other sources: Sources outside QuickBooks. A ready-made monthly request by email: Ask each company for the month's exports.

Connectors never add files to a company, change a mapping, close, lock or reopen a month, or put figures into a closed month: the app's own controls do that, and from a chat Haruno may change only a company's mapping, when you ask (Asking Haruno). Nor do connectors watch your inbox or calendar. Haruno uses one when you ask in a chat or when a scheduled task runs at its set time, and only while Haruno is running.

Open the Connectors window

Connectors has a window of its own, opened from the account menu, not from Settings. A message that points you to Connectors means this window.

  1. Click the account row at the bottom of the sidebar, where your name or email is, and choose Connectors….
  2. On the connector's row, click Sign in or Connect. Office Tools has a switch instead.

Rows are grouped under Google (Gmail, Google Calendar, Google Drive), Cloud storage (OneDrive, SharePoint, Dropbox), Communication (Slack, Discord) and Built-in tools (Office Tools), plus Custom MCP servers in the Advanced view. Web search, and reading the documents, PDFs, images and audio you give Haruno, are always on and have no row. Connectors wait for the secure sandbox's one-time setup after you install Haruno; until then, a line at the bottom of the window says what it is doing. See The secure sandbox.

Most connectors sign in on the service's own page in your browser. Discord takes a bot token. Slack signs in through Haruno's service, so sign in to Haruno first (account menu ▸ Sign In…) and finish in the browser within about three minutes. Meanwhile the row (for cloud storage, the sheet) reads Finish signing in in your browser… with a Cancel button.

Once connected, the Gmail, Google Calendar, Slack and Discord rows, and each custom server, have a switch: off keeps the sign-in but stops Haruno using it. Cloud storage has none; the folders you share decide what Haruno may use.

Connectors that can reach other people also have a Require confirmation before… setting, on by default: Haruno asks you in the chat before it sends, posts or changes something there. Cloud storage always asks. Leave these on; they are how you review an email before it reaches a company. See Connector confirmation switches. A change in this window reaches the next chat you start, not one already open, so start a new chat (⌘N) before you rely on it.

QuickBooks Online

QuickBooks Online has no row in Connectors, and no chat or scheduled task is given a QuickBooks tool. Connect a company, sync its months and close them as QuickBooks Online describes; the chat then answers from the company's books and says which month they run through. Haruno only reads from QuickBooks.

Google: Gmail, Google Calendar and Google Drive

Each Google service has its own sign-in in your browser. What it can do depends on the Google app the sign-in goes through: Haruno's built-in app, or your organization's Google app, if your organization already has one (Your organization's Google app).

ConnectorBuilt-in Google appYour organization's Google app
GmailSend email and manage labels only.Also search and read mail, save attachments, reply in a thread and move mail to Trash.
Google CalendarSee, add, change and delete events.The same.
Google DriveOnly a folder Haruno creates.Your own My Drive, if you keep full Drive access selected. Not shared drives or folders only shared with you.

Connect Gmail or Google Calendar

  1. Click Sign in on the Gmail or Google Calendar row, then allow the access Google lists in your browser. For Gmail, keep “Send email on your behalf” selected, or Gmail is not connected.
  2. When the page says “Signed in ✓”, return to Haruno. The row shows the account, a switch and a ⋯ menu.

Gmail and Google Calendar each connect one Google account on this Mac; signing in with another replaces it. Through your organization's app, Haruno can save an email's attachment in the chat's working folder, which is the folder you opened with File ▸ Open Folder… or Haruno's own Workspace folder. To close on it, add it to the company like any other export.

Connect Google Drive

  1. Click Connect on the Google Drive row, then Continue to Google Drive, and allow access in your browser. Keep Drive access selected, or the connection is not created. With your organization's app, keep “See, edit, create and delete all of your Google Drive files” selected to reach your My Drive; leave it off and Haruno uses only its own folder.
  2. Click Save, tick the folders Haruno may use or turn on Share everything, then click Save.

Google Drive then works like the other cloud storage connections. If your organization's Google app changes, the row tells you when to sign in again; see What happens to members' connections.

OneDrive, SharePoint and Dropbox

The Cloud storage section keeps folders from OneDrive, a SharePoint document library or Dropbox in sync with a copy on this Mac, as Google Drive does. In OneDrive, SharePoint, Dropbox and Google Drive you choose the folders Haruno may use, and it never deletes anything there; it can move a file to the trash after you approve. OneDrive and Google Drive reach only your own drive, so a shared drive, or a folder only shared with you, may not appear; download such a file instead.

  1. Click Connect on the provider's row. OneDrive offers Tenant (optional); SharePoint takes Site ID (optional) or Drive ID (optional).
  2. Click Continue to OneDrive, SharePoint or Dropbox and sign in. OneDrive, SharePoint and Dropbox ask for access to your whole account; the folder choice is what limits Haruno.
  3. Click Save, then choose the folders Haruno may use and click Save.

    Until you do, the row reads “No folders shared yet — choose which folders Haruno can use” with a Choose folders… button.

The row's ⋯ menu has Shared folders…, Re-check, Edit…, Add another account… and Sign out…. The row also shows Syncing…, Synced or Sync error for the copy on this Mac, and Re-check tests the connection. When you stop sharing a folder, you choose whether to delete what Haruno downloaded from it; files in the cloud are not changed. In a chat, Haruno asks before it opens a cloud folder on this Mac, syncs it or uploads a file, and an opened folder stays in two-way sync, so changes Haruno makes go back to the cloud. Only Google Drive can be searched.

A shared folder is not a company's books
Files in a synced folder stay outside the close. To close on an export a company shared in a drive, download it to your Mac and add it to the company like any other export. Haruno can list the folder, or search Google Drive, to find it.

Slack

Slack lets Haruno post messages and read channels in your workspace, in a chat: post a close status to your finance channel, or find a colleague's question about a company. Click Sign in on the Slack row and choose the workspace in your browser; sign in to Haruno first.

Slack is for chats, not scheduled tasks
A scheduled task is never given Slack, or any other server you added, so nothing it does can post there. To post to Slack, ask in a chat, where Require confirmation before posting and writing still applies.

Discord

Discord connects through a bot you create and invite to your server. Haruno can then read messages, and post messages and files, in the channel you choose and in any other channel the bot can see, so limit the bot's access in Discord if it should stay in one.

  1. In Discord's developer portal, create an application, reset the token on its Bot page, and invite the bot to your server with permission to send messages and attach files.
  2. Click Connect on the Discord row, paste the token into Bot token, click Continue, pick the Server and Channel, and click Use this channel.

If the bot's Message Content Intent is off in the developer portal, messages Haruno reads come back blank unless they mention the bot. In a scheduled task, a Discord post is held for you in Waiting.

Web search is always on while you are signed in, with no row. Haruno searches when a question needs current public information, such as a change to a standard, a tax rate or a filing deadline. The search words leave your Mac, so keep a company's confidential details out of what you ask it to look up. When Haruno asks before a search, the card reads Haruno wants to search the web. with Your search text leaves your Mac. Treat a result as a lead: open the source and check its date. Opening a page can ask Let Haruno open this website? (Websites).

Office documents

Office Tools lets Haruno create and edit Word, Excel and PowerPoint files, such as a roll-forward schedule, a board memo or a results deck, without Microsoft Office installed. It is on by default when Word, Excel or PowerPoint is installed; otherwise the row reads “Microsoft Office not installed” and you can still turn it on. Once you set it yourself, your choice stays. Reading workbooks, documents, PDFs and images, transcribing audio and making a PDF work either way. Previewing and saving what it writes: Documents Haruno writes.

A workbook Haruno builds is a working paper
It is saved in the folder the chat works in (Files tab, ⌘3) and does not change the ledger; the statements and reports are drawn only from the books. Check its figures against the company's reports before you send it on.

Custom servers (Advanced view)

In the Advanced view, the Connectors window has a Custom MCP servers section for connecting Haruno to a server of your own. MCP, the Model Context Protocol, is an open standard for offering tools to an AI assistant. Most finance teams never need this.

  1. Turn on the Advanced view in Settings ▸ General.

    See The normal view and the Advanced view.

  2. Click Add server, fill in Name and Server URL (normally https://…), and choose the Authentication: None, Header or OAuth.
  3. Click Connect, set each tool to On, Confirm or Off, then click Save.

    Confirm makes Haruno ask you in the chat before each use. See Per-tool settings for custom servers.

The secure sandbox cannot reach a server on this Mac at a localhost address; use a hostname or network address. Turning the Advanced view off hides the section; if Haruno should stop using a server, switch it off or remove it first.

Before you add one
A custom server receives whatever Haruno sends it, which can include figures and names from your books, and Haruno does not review what the server does with them. A scheduled task is never given a custom server. Add only servers your firm runs or trusts.

Connectors in scheduled tasks

Nobody confirms in a scheduled task, so the confirmation settings do not apply. Emails, replies, calendar invitations with guests, Discord posts and changes to a synced cloud folder wait in Waiting until you send them. Labels, moves to Trash and events without guests happen at once; changing or deleting an existing event is refused. A task allowed to send on its own does all of these at once. A task is never given Slack or a custom server, whatever it may send. See What waits and what happens at once.

What a connector shares, and where sign-ins are kept

Connector sign-ins stay in your Mac's login keychain. They do not move to another Mac or to the Windows app, and deleting your Haruno account leaves them in place. A connector that is switched on also lets the secure sandbox reach its service, so you are not asked to allow it as a website. What a service returns becomes part of the chat, which goes through Inferara's hosted service to the model provider. See Data handling and security.

Disconnecting

Switch a connector off to pause it; the sign-in stays. To end it, use the row's ⋯ menu.

ConnectorMenu itemWhat happens
Gmail, Google Calendar, SlackSign outDeletes the sign-in and asks the service to end Haruno's access.
Google Drive, OneDrive, SharePoint, DropboxSign out…Deletes the sign-in; you choose whether to keep the downloads. Cloud files are not changed.
DiscordDisconnectDeletes the bot token. The bot stays in your server until you remove it in Discord.
Custom serverRemoveHaruno can no longer use it.

To be sure access has ended, also remove Haruno in the service's own account settings. Delete local data… erases every connector sign-in on this Mac along with everything else Haruno keeps there, the books included, and contacts no service (Delete local data). If a service rejects a saved sign-in, Haruno turns that connector's tools off for up to a day, or until you sign in again from its row. Then start a new chat.

Messages you may see

Most messages are in Troubleshooting ▸ Connectors, and Google's in On a member's Mac. The rest:

What you seeWhat to do
“Sign in to Haruno in Settings before connecting Slack.”Account menu ▸ Sign In…, then connect.
“Slack sign-in timed out. Please try again.”Sign in again and finish in the browser within about three minutes.
“Discord did not accept that bot token. Copy it again from the Bot page of your application.”Copy the token again from the developer portal.
“This bot has not been invited to a server yet. …”Invite it from the developer portal, then reopen the sheet.
“The bot cannot see that channel. …” or “The bot cannot see any text channels in that server. …”Give the bot access to a channel in Discord, then try again or pick the server again.
“Discord is asking us to slow down. Wait a moment and try again.”Wait, then try again.
“This Google service isn't switched on for the Google app this sign-in used. …”Your organization admin switches the service on for its Google app.
“This connection now only sees the Haruno folder in your Google Drive. …”⋯ ▸ Edit…, sign in again with full Drive access, then choose the folders again.
“Use an https:// URL.”Give the custom server an https:// address.
Unlock your keychain to reconnect.Unlock your Mac's login keychain.
Sign in again soon to keep this connection working.The Google connection was made through an app Haruno no longer has. Sign in again.
Tools server unavailableQuit and reopen Haruno. If it stays, contact support.

On Windows

The Windows app has connectors too. Where they differ from the Mac's, see Haruno on Windows.

TopicMacWindows
WhereAccount menu ▸ Connectors…Settings ▸ Connectors, in the Integrations card
Turning one onSign in or ConnectEnable downloads its signed package from Haruno's catalog; then Connect
Custom serversAdvanced view onlyAdvanced view only, not in sandboxed sessions
Scheduled tasksOutward actions held in WaitingA tool set to Confirm is refused; no Waiting queue
RemovingSign out or DisconnectRemove deletes the package and its stored account details

Connectors only the Windows app has

ConnectorWhat it does
Outlook MailSearch, read, send, reply to and delete mail.
Outlook CalendarRead and manage events.
NotionSearch and update a workspace.
TelegramA bot for messages and files.
YayoiMisoca invoicing. An organization administrator registers the organization's Misoca app first.
弥生会計 NextExports one month's journal or trial balance into the project folder. Read only: nothing is created, changed or paid in 弥生会計. To close a month on it, add the trial balance ZIP to the company.

The list comes from Haruno's catalog, so it can change without an app update. Git, LinkedIn, WhatsApp and X are offered only on a PC that already has one, and QuickBooks Online is not a connector. Web search and reading and previewing files are always on, with no card. Approvals: Approvals on Windows. On Windows, Google Drive asks you to choose Haruno connection folder or My Drive: Google connectors on Windows.

Next steps

Connectors serve chats and scheduled tasks. The close runs on the exports you add or the months Sync brings in.