Import from Google Calendar

Bring the upcoming appointments on your Google calendars into HandymanPro as scheduled jobs, reviewing every entry first.

Last updated: October 22, 2026

Who this is for

Teams that ran their schedule on Google Calendar before HandymanPro, or still keep some work there. The import reads your calendars (it never writes to Google), proposes what each entry should become, and lets you confirm or change every row before it creates jobs.

Only admins with access to Settings can connect Google and run an import.

Step 1: Connect Google

  1. Open Settings → Integrations and find the Import from Google Calendar card.
  2. Click Connect Google. You are sent to Google's sign-in page.
  3. Choose the Google account that owns or can see the calendars you want to import.
  4. On the permission page, leave "See and download any calendar you can access" ticked, then click Continue. If you untick it, Google connects your account without calendar access and HandymanPro will ask you to connect again.
  5. You land back on the Integrations card, which now shows Connected as your Google address.

"Google hasn't verified this app." You may see this screen while Google's review of the integration is in progress. Click Advanced, then Go to HandymanPro. It is safe: the permission requested is read-only access to calendars.

HandymanPro keeps a long-lived connection, so you connect once. Disconnect on the same card removes HandymanPro's access at Google and forgets the connection; imports you already ran are kept.

Step 2: Choose calendars and a date range

Click Import from Google Calendar → on the card. The import page opens.

  1. Every calendar the connected account can see is listed. Tick the ones to import. Holiday and birthday calendars are best left unticked.
  2. Default tech. If a calendar belongs to one person (an "Ed – field" calendar), pick that tech here and every entry from it lands on them. For a shared team calendar leave it unassigned and pick techs row by row in the next step.
  3. From / To. Only upcoming entries are pulled. The range starts today and defaults to 90 days ahead; the maximum is 12 months.
  4. Click Pull events. Nothing is created yet.

Recurring events come in as one row per occurrence inside the range. Entries you declined, and events that were cancelled, are not pulled.

Step 3: Review

Each pulled entry is one row. Change anything, and your edits save as you go, so you can leave and come back.

Column What it shows What you can do
When Date and start time from Google Edit the start. Times snap to the half-hour grid the schedule uses.
Title / location The Google entry —
Kind Job, Calendar event, or Skip Change it. See the rules below.
Customer The customer HandymanPro matched, with a tag showing how Change to pick another customer, or fill in a new customer for a job.
Tech Who the job or event is for Pick a tech. Required for calendar events.

How HandymanPro decides the kind. An entry becomes a Job only when it finds a solid customer match: a guest email on the invite that matches a customer, a phone number in the title or notes that belongs to exactly one customer, or a customer's full name before a dash or colon in the title ("Pat Siegel – replace storm door"). Everything else starts as a Calendar event, so the import never guesses a customer for you. A likely-but-unsure match shows as "Possible match" so you can confirm it with one click.

Tags next to the customer. email, phone and name show what matched. chosen means you picked the customer yourself.

Flags under the date.

  • all day: an all-day entry. As a calendar event it spans your business hours. If you flip it to a job it starts at opening time and lasts 2 hours, which you can edit.
  • shortened: the entry ran past midnight; it was cut at the end of that business day.
  • already imported: this entry was created by an earlier import. It is set to Skip, with a link to the existing job. Leave it skipped unless you deleted that job on purpose.
  • double-booked: after import, the tech already had something in that time. The job was created anyway, since it was already on their calendar; the schedule shows the overlap.

New customers. When a job has no match, fill in the first and last name (pre-filled from the title) and the address (pre-filled from the entry's location). The customer is created when you import. Prefer Pick existing when the person is already in HandymanPro, to avoid duplicates.

Bulk buttons.

  • Unmatched → Skip marks every row without a customer as Skip.
  • All → Event turns every pending row into a calendar event.
  • Re-pull fetches the calendars again. Entries you already edited keep your decisions, entries deleted in Google are marked gone and skipped, and rows you have already imported are never changed.

Filters narrow the table by calendar, match state, or kind. Filters only hide rows; they do not change them.

Step 4: Import

The button reads Import N jobs, M events. Click it and confirm. HandymanPro then creates, row by row:

  • Jobs: a scheduled job for the customer, on the date and time shown, assigned to the tech, with the right blocks on the schedule. The entry's notes go into the job description, with a line saying it came from Google Calendar.
  • Calendar events: a plain event on the tech's schedule (not a job). An event with no tech does not import; pick a tech or skip it.
  • Skip: nothing.

Nothing is emailed or texted to anyone as a result of an import.

Results. Imported rows turn grey and show a link to the job. Rows that could not be imported turn red with the reason and stay editable; fix them and click Import again, and only those rows are retried. The most common reasons:

  • "Tech unavailable: that time is locked on the schedule." The tech has a blocked-off period there (vacation, training). Move the time or pick another tech.
  • "A job needs a customer." Pick one or fill in the new-customer fields.
  • "Calendar events need a tech to appear on the schedule." Pick a tech or skip the row.
  • "Already imported as job #N." The entry already exists from an earlier import.

Start over abandons the current review and takes you back to choosing calendars. Rows already imported stay imported.

Running it again later

Connect once, then import as often as you like. Each new pull recognises entries that were imported before and skips them automatically, so re-importing the same calendar next week only brings in what is new. Entries you edit in Google after importing are not updated in HandymanPro; change the job there.

Questions

  • Does it change my Google Calendar? No. Access is read-only.
  • Can techs connect their own calendars? Not in this version. An admin connects one Google account; add that account to the techs' calendars in Google if you want to import theirs.
  • Did it book a time twice? Rows flagged double-booked were imported on purpose because the entry already existed on the tech's calendar. Resolve the overlap on the schedule as usual.
  • What if I connected the wrong Google account? Click Disconnect on the Integrations card and connect again with the right one.