How Cocal works

Connect your calendars, choose what Cocal can use, and start planning in your chat.

From setup to your first plan

Create your Cocal account, then follow these four steps.

1
Connect your calendar accounts
Add the accounts you use for work and life. You can connect one account now and add others later.
- Google Calendar
- Outlook
- iCloud Calendar
2
Choose the calendars to include
Review whose calendars they are: yours, a partner’s, family, or other people you coordinate with. Turn off any calendars you don’t want Cocal to use.
What does this calendar represent?Shared household
Try the sample calendars. Changes stay in this example.
3
Connect your assistant
Choose Claude, ChatGPT, Gemini, or Claude Code. The connection guide walks you through adding Cocal and approving access.
Server URL
https://mcp.cocal.io/mcp
4
Start with your day
Ask Use Cocal to show my events tomorrow. Then keep going: find an opening, add the details, or make a plan.
Interactive calendar with sample events.

Add optional rules in chat or in your account. Cocal brings them into each new conversation, whichever assistant you use.

See your calendar and work with events on web, desktop, and mobile.

Add Cocal through Plugins. Availability depends on your plan and workspace settings.

Add Cocal as a custom Connected App. Check the guide for account and region requirements.

Check your day, find open time, and create events from the terminal.

The visual calendar appears in supported chat interfaces. Where it isn’t available, you can still check availability and manage events through text.

Your enabled calendars: Cocal reads events and makes changes on the calendars you enable, within the permissions you grant. Change your selection in your account.
Review guest invitations: By default, new events and updates with guests outside your own calendars show a preview before the change is made. Review the details and recipients there. You can adjust this in Event previews.
Your data and connections: Cocal reads calendars directly from your provider. Its activity log records actions, not event contents; invite links store the details needed to show the event. You can disconnect an account at any time.

Start with the calendars you use. Your account guides you through the connection.