Learn Mokapen

Google Calendar

This integration connects Mokapen's Appointments module to your Google Calendar. Meetings and appointments can travel between the two systems according to the rules you set — without manual exports or double entry.

It does not sync tasks: on the page, the task option is disabled (coming soon). It applies only to appointments with a date and time.

General integrations overview: Integrations.

Requirements

• Mokapen plan with calendar integration (Premium badge icon on the appointments menu item). Without a suitable plan, the connect button opens the upgrade page.
• Google account with an active calendar.
• Permission to authorize Mokapen to manage calendar and events on Google.

Connecting Google Calendar

1. User menu → Integrations → Google Calendar tab.
2. Click Sync Google Calendar (or equivalent).
3. On Google: choose the account (it may be different from the email you use to log in to Mokapen).
4. Review the requested permissions (calendar and events) and click Allow.
5. You return to Mokapen: Connected account: appears with the authorized Google email.

If you do not accept the permissions, the connection will not complete and no appointments will be synced. Automations that depend on the calendar will not be able to use Google events.

If you see "connection expired", click Disconnect and connect again.

What Mokapen requests from Google

In addition to profile name and email, Mokapen requests access to the calendar and events: read existing meetings, create new ones from Mokapen, update them, and delete them when you modify or cancel a linked appointment. Without these permissions, sync will not start.

Google email different from Mokapen email

This is allowed and common: you work in Mokapen with one login and sync the team@company.com calendar or a personal Gmail. On the integration page, the email under Connected account is the one that matters for sync, not your Mokapen login email.

Same address (Mokapen = Google): export/import preserves organizer and participants; unknown emails on import may create contacts (email only) in the address book.

Different addresses:

• On Google, the connected account must be the organizer or a participant of the event; otherwise Google will not accept the write operation.
• On export: if the Mokapen organizer does not exist on that calendar, the event is created with the connected Google account as organizer.
• On import: if your Mokapen user participates in the event, the appointment enters Mokapen; if not, the event may remain imported but not visible to you; events without useful participants may be ignored.

Tip: add yourself as a participant to appointments that should appear in both systems, or use the same email address where possible.

Settings to configure

Sync direction

Three modes (arrows on the page):

• Mokapen only — Google feeds the CRM; changes in Mokapen do not go back to Google.
• Google only — Mokapen sends appointments to the calendar.
• Both — updates in one system are reflected in the other.

Calendars

• Primary calendar — Mokapen uses the one marked as primary in Google (not editable from the menu).
• Other calendars — select secondary calendars (Clients, Team…). Birthdays and holidays are automatically excluded.

Other controls

• Sync appointments — must remain enabled.
• Start date — from which day to import past events (max 15 days back); forward approximately one year.
• Google Meet (if your plan allows) — adds a video conference link to exported appointments.

Click Save to store settings, Sync to run the alignment.

What happens during sync

• New appointment in Mokapen → event on Google (if export is active).
• Edit or delete in Mokapen → update or remove the linked Google event.
• New event on Google → appointment in Mokapen (if import is active and within the date range).
• Edit on Google → Mokapen updates the linked appointment (automatic notifications from Google when possible).

Common issues

• Missing events — check start date, selected calendars, sync direction, email participation when accounts differ.
• Duplicate events — two connections or the same event imported and recreated manually; merge and use a single official calendar.
• Slow sync — normal on the first run with many events.

Disconnecting

Click Disconnect, confirm by typing the requested word, and proceed. Mokapen stops the connection with Google Calendar and removes sync references between appointments and events.

What happens to the data:

• Appointments in Mokapen — remain in the CRM as normal records, but are no longer synced with Google (no automatic updates in either direction).
• Events on Google Calendar — are not deleted automatically by Mokapen.

Unlike contacts or Drive, the Calendar disconnect window does not offer checkboxes to bulk-delete already imported appointments: in practice you keep them in Mokapen, disconnected from sync. If you want to clean up the CRM, delete or edit appointments manually after disconnecting.

Managing appointments in the CRM: Appointments guide.