Calendar Integration Guide
Grant Kocoro Calendar access and the AI can read and manage your Mac calendar directly — check this week's schedule in one sentence, tidy up your agenda, and create events for you. Through macOS Internet Accounts, you can also bring in iCloud, Google and Microsoft (Exchange/Outlook) calendars in one place.
Before you begin
- You have the Kocoro Mac App installed and you're on macOS.
- The calendar feature relies on the system's built-in Calendar and Internet Accounts — no extra plugin to install.
- To let Kocoro manage Google or Microsoft calendars, add those accounts in System Settings first (see Part 2).
Part 1 · Grant Kocoro Calendar access
1Open Permissions and find “Calendar”
Launch Kocoro, click Settings in the lower-left corner, and open the Permissions tab. Find the Calendar row in the list and click Grant on the right.
Settings → Permissions → find Calendar, click Grant - 2
Click “Allow Full Access” in the system prompt
macOS will ask: “Kocoro Desktop” would like full access to your Calendar. This lets Kocoro read your schedule and create, update, or delete events on your behalf. Click Allow Full Access.
System prompt → click Allow Full Access - 3
See the green check — you're done
Once granted, the Calendar row shows Full access granted with a green check. You're ready to go.
If the status doesn't update right away, click Refresh Status in the top-right corner, or reopen Kocoro.“Full access granted” — authorization complete Part 2 · Connect Google / Microsoft and other calendars (optional)
4Open “Internet Accounts” in System Settings
If your schedule lives in Google or Microsoft, bring it onto your Mac. Open System Settings → Internet Accounts and click Add Account… Accounts you've already added (like iCloud) appear here too.
System Settings → Internet Accounts → click Add Account… - 5
Choose your calendar provider
Pick your provider from the list: Microsoft Exchange (covers Outlook, Microsoft 365 and Teams calendars), Google, iCloud, Yahoo, and more. Follow the prompts to sign in to your account.
Choose a provider and sign in - 6
Make sure “Calendars” is checked
After signing in, macOS asks which items to enable for this account. Make sure Calendars is checked, then click Done. Other items (Mail, Contacts, etc.) are up to you.
Only when Calendars is checked will this account's schedule show up on your Mac — and only then can Kocoro read and manage it.Check Calendars → click Done
Start using it
Once access is granted, just talk to Kocoro about your schedule in plain language. Here are the two most common scenarios.
① Check your schedule
Ask “What are my important upcoming plans?” and Kocoro reads all connected calendars, organizes them by today / this week / next week, and highlights what deserves your attention.
② Create an event
Just say “Schedule a meeting with Mr. Tony next Monday at 10 AM to discuss the IPO plan.” Kocoro finds the right calendar, creates the event, and tells you the title, time, and which calendar it landed in.
Important note about Microsoft (Exchange / Outlook / Teams) calendars: Kocoro can create events on a Microsoft calendar, but it cannot add attendees or send meeting invitations — because we have no way to access participants' accounts. If you need to formally invite colleagues or external guests, please add the attendees and send the invitation manually from Teams or Outlook after the event is created.
A created event appears both in Kocoro's built-in calendar view (edit or delete it anytime) and in the Mac's built-in Calendar app. In the screenshot below you can see the event's Add Invitees field is empty in the system Calendar — exactly the Microsoft limitation described above.
Prompts to try
- What are my important upcoming plans?
- Schedule a 1-hour meeting with Mr. Tony next Monday at 10 AM to discuss the IPO plan.
- Turn my agenda for today into a checklist.
- Which days this week have in-person events? Highlight them for me.
Troubleshooting
I can't find the Calendar permission, or nothing happens after I click Grant.
First make sure Kocoro is updated to the latest version. If no system prompt appears after clicking Grant, or the status doesn't refresh, click Refresh Status in the top-right of the Permissions page, or restart Kocoro and check again.
I added a Google / Microsoft account, but my schedule isn't showing up.
Most likely Calendars wasn't checked when you added the account. Go back to System Settings → Internet Accounts, open the account, and confirm Calendars is turned on. Give it a moment to sync, then ask Kocoro to read your calendar again.
Where did my created event go?
The event is created in one specific calendar (for example, a particular Exchange/Google account). Kocoro tells you which calendar it used in its reply. You can find it in Kocoro's built-in calendar view or in the Mac's built-in Calendar app.
Why can't I add attendees to a Microsoft calendar meeting?
This is a Microsoft calendar limitation: without signing in to each attendee's account, it can't add participants or send meeting invitations on your behalf. Kocoro will create the event itself — please send the formal invitation manually from Teams or Outlook.