Haruno Knowledge base

Gmail and Google Calendar

Let Haruno work with your Gmail and your main Google calendar. What each can do, what Haruno asks first, and what a scheduled task holds for your approval.

  • Mac appAvailableReading mail is not available on Haruno's own Google connection; the Gmail row says so.
  • Windows appAvailableGmail and Google Calendar are two connectors on Windows.

Gmail and Google Calendar are two connectors in the Google section of the Connectors window. Each is its own sign in, and you can use one without the other.

What Haruno can do

ConnectorWhat Haruno can do
GmailSearch your mail and read a message. Save an attachment to a file. List, create and rename labels. Send a new email, with attachments. Reply in a thread. Move a message to Trash
Google CalendarList upcoming events. Create, change and delete events on your main calendar

Gmail keeps a message in Trash for about 30 days, so a trashed message can still be recovered in that time.

Reading mail depends on how Google is connected

After you sign in, the Gmail row can say: Send email and manage labels. Reading mail isn't available on Haruno's built-in Google app. When it does, Haruno can send email and manage labels. It cannot search, read, reply to or trash mail. A member of an organization sees Reading mail needs the Google app your organization sets up. instead. When the row has no such sentence, reading is on.

Connect

  1. Open Connectors

    Choose Connectors… from your account at the bottom of the sidebar.

  2. Click Sign in

    Click it on Gmail, on Google Calendar, or on both.

  3. Approve in your browser

    The row says Finish signing in in your browser…. Choose your Google account and approve. Click Cancel to stop.

When it is done, the row shows your account and the connector is on. If your organization has its own Google connection, the row also says Connected through your organization's Google app.

The ⋯ menu has Sign in again and Sign out. Use Sign in again if the row says Google refused the saved sign in. Sign out removes the sign in from this Mac and asks Google to end Haruno's access.

What Haruno asks first

Two switches are on until you turn them off.

ConnectorSwitchHaruno asks before
GmailRequire confirmation before sending, replying, and deletingSending, replying, moving to Trash
Google CalendarRequire confirmation before changing eventsCreating, changing or deleting an event

In a chat, an event with guests also tells you that the guests will get an invitation.

In a scheduled task

A scheduled task has nobody to ask. Anything that would reach other people is prepared and held. You approve it in The Waiting queue.

What Haruno doesIn a scheduled task
Search and read mail, save an attachmentWorks
Create or rename a label, move a message to TrashWorks. The run reports a trashed message
Send a new emailHeld in Waiting
Reply to a messageHeld in Waiting
List events, add an event with no guestsWorks
Add an event with guestsHeld in Waiting. The guests are emailed only when you approve
Change or delete an eventRefused. The run says to do it while you are at your Mac

A task you allowed to send on its own does not hold these. That switch is off by default. See Scheduled tasks.

Who has it

Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use these connectors. See The Connectors window.

What to tell a customer

Sign in to Google once for Gmail and once for Google Calendar. Haruno asks before it sends mail or changes your calendar. If the Gmail row says reading mail is not available, Haruno can send email but cannot read it. A scheduled task never sends anything by itself unless you allow that for the task.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,80 @@
    +---
    +title: Gmail and Google Calendar
    +summary: Let Haruno work with your Gmail and your main Google calendar. What each can do, what Haruno asks first, and what a scheduled task holds for your approval.
    +feature: mail-and-calendar-connectors
    +covers:
    +  - Integrations/gmail/**
    +  - Integrations/calendar/**
    +  - vc-tools/VcTools.McpServer/Servers/Gmail/**
    +  - vc-tools/VcTools.McpServer/Servers/Calendar/**
    +  - apple/Sources/BackendServices/Gmail/**
    +  - apple/Sources/BackendServices/Google/**
    +---
    +
    +Gmail and Google Calendar are two connectors in the <Ui>Google</Ui> section of the [Connectors window](/macos/connectors/connectors-window/). Each is its own sign in, and you can use one without the other.
    +
    +## What Haruno can do
    +
    +| Connector | What Haruno can do |
    +|---|---|
    +| Gmail | Search your mail and read a message. Save an attachment to a file. List, create and rename labels. Send a new email, with attachments. Reply in a thread. Move a message to Trash |
    +| Google Calendar | List upcoming events. Create, change and delete events on your main calendar |
    +
    +Gmail keeps a message in Trash for about 30 days, so a trashed message can still be recovered in that time.
    +
    +<Callout variant="warning" title="Reading mail depends on how Google is connected">
    +After you sign in, the Gmail row can say: <Ui>Send email and manage labels. Reading mail isn't available on Haruno's built-in Google app.</Ui> When it does, Haruno can send email and manage labels. It cannot search, read, reply to or trash mail. A member of an organization sees <Ui>Reading mail needs the Google app your organization sets up.</Ui> instead. When the row has no such sentence, reading is on.
    +</Callout>
    +
    +## Connect
    +
    +<Steps>
    +<Step title="Open Connectors">
    +Choose <Ui>Connectors…</Ui> from your account at the bottom of the sidebar.
    +</Step>
    +<Step title="Click Sign in">
    +Click it on Gmail, on Google Calendar, or on both.
    +</Step>
    +<Step title="Approve in your browser">
    +The row says <Ui>Finish signing in in your browser…</Ui>. Choose your Google account and approve. Click <Ui>Cancel</Ui> to stop.
    +</Step>
    +</Steps>
    +
    +When it is done, the row shows your account and the connector is on. If your organization has its own Google connection, the row also says <Ui>Connected through your organization's Google app</Ui>.
    +
    +The ⋯ menu has <Ui>Sign in again</Ui> and <Ui>Sign out</Ui>. Use <Ui>Sign in again</Ui> if the row says Google refused the saved sign in. <Ui>Sign out</Ui> removes the sign in from this Mac and asks Google to end Haruno's access.
    +
    +## What Haruno asks first
    +
    +Two switches are on until you turn them off.
    +
    +| Connector | Switch | Haruno asks before |
    +|---|---|---|
    +| Gmail | <Ui>Require confirmation before sending, replying, and deleting</Ui> | Sending, replying, moving to Trash |
    +| Google Calendar | <Ui>Require confirmation before changing events</Ui> | Creating, changing or deleting an event |
    +
    +In a chat, an event with guests also tells you that the guests will get an invitation.
    +
    +## In a scheduled task
    +
    +A scheduled task has nobody to ask. Anything that would reach other people is prepared and held. You approve it in [The Waiting queue](/macos/automation/waiting-queue/).
    +
    +| What Haruno does | In a scheduled task |
    +|---|---|
    +| Search and read mail, save an attachment | Works |
    +| Create or rename a label, move a message to Trash | Works. The run reports a trashed message |
    +| Send a new email | Held in Waiting |
    +| Reply to a message | Held in Waiting |
    +| List events, add an event with no guests | Works |
    +| Add an event with guests | Held in Waiting. The guests are emailed only when you approve |
    +| Change or delete an event | Refused. The run says to do it while you are at your Mac |
    +
    +A task you allowed to send on its own does not hold these. That switch is off by default. See [Scheduled tasks](/macos/automation/scheduled-tasks/).
    +
    +## Who has it
    +
    +Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use these connectors. See [The Connectors window](/macos/connectors/connectors-window/).
    +
    +## What to tell a customer
    +
    +Sign in to Google once for Gmail and once for Google Calendar. Haruno asks before it sends mail or changes your calendar. If the Gmail row says reading mail is not available, Haruno can send email but cannot read it. A scheduled task never sends anything by itself unless you allow that for the task.