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 to | Use |
|---|---|
| Ask a company for its month-end exports by email | Gmail, with any Google sign-in |
| Find a company's exports in your mail and save the attachments | Gmail, through your organization's Google app |
| Work with files in cloud storage or a SharePoint library | Google Drive, OneDrive, SharePoint or Dropbox |
| Block time for the close, or check your calendar | Google Calendar |
| Post a close update to your team | Slack in a chat, or Discord through a bot you create |
| Build a schedule in Excel, a memo in Word or a board deck in PowerPoint | Office Tools. Microsoft Office is not required. |
| Look up a standard, a rate or a filing deadline | Web search, always on while you are signed in |
| Ask about a company's QuickBooks figures | No 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 calendar | The Windows app only |
| Bring in figures from a bank, payroll, Stripe or HubSpot | No 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.
- Click the account row at the bottom of the sidebar, where your name or email is, and choose Connectors….
- 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).
| Connector | Built-in Google app | Your organization's Google app |
|---|---|---|
| Gmail | Send email and manage labels only. | Also search and read mail, save attachments, reply in a thread and move mail to Trash. |
| Google Calendar | See, add, change and delete events. | The same. |
| Google Drive | Only 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
- 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.
- 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
- 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.
- 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.
- Click Connect on the provider's row. OneDrive offers Tenant (optional); SharePoint takes Site ID (optional) or Drive ID (optional).
- 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.
- 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.
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.
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.
- 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.
- 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
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.
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.
- Turn on the Advanced view in Settings ▸ General.
- Click Add server, fill in Name and Server URL (normally https://…), and choose the Authentication: None, Header or OAuth.
- 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.
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.
| Connector | Menu item | What happens |
|---|---|---|
| Gmail, Google Calendar, Slack | Sign out | Deletes the sign-in and asks the service to end Haruno's access. |
| Google Drive, OneDrive, SharePoint, Dropbox | Sign out… | Deletes the sign-in; you choose whether to keep the downloads. Cloud files are not changed. |
| Discord | Disconnect | Deletes the bot token. The bot stays in your server until you remove it in Discord. |
| Custom server | Remove | Haruno 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 see | What 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 unavailable | Quit 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.
| Topic | Mac | Windows |
|---|---|---|
| Where | Account menu ▸ Connectors… | Settings ▸ Connectors, in the Integrations card |
| Turning one on | Sign in or Connect | Enable downloads its signed package from Haruno's catalog; then Connect |
| Custom servers | Advanced view only | Advanced view only, not in sandboxed sessions |
| Scheduled tasks | Outward actions held in Waiting | A tool set to Confirm is refused; no Waiting queue |
| Removing | Sign out or Disconnect | Remove deletes the package and its stored account details |
Connectors only the Windows app has
| Connector | What it does |
|---|---|
| Outlook Mail | Search, read, send, reply to and delete mail. |
| Outlook Calendar | Read and manage events. |
| Notion | Search and update a workspace. |
| Telegram | A bot for messages and files. |
| Yayoi | Misoca invoicing. An organization administrator registers the organization's Misoca app first. |
| 弥生会計 Next | Exports 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.