Google Calendar Connector

The Google Calendar connector links your Google account to Pieces so Conversational Search can both read your schedule and act on it—creating events, inviting attendees, rescheduling meetings, and more.

Once connected, you can ask Pieces things like "What do I have tomorrow afternoon?" or "Schedule a 30-minute sync with Alice next Tuesday at 2pm with a Google Meet link."

Connecting Google Calendar

Connect your Google account through a standard OAuth flow in your default browser.

In the Pieces Desktop App, open `Settings` and select `Connectors`. Click `Connect` next to *Google Calendar*. Pieces opens your default browser to Google's authorization page. Sign in to the Google account you want to connect and grant the requested calendar permissions. Once authorization completes, your browser redirects back to Pieces. The connector's button changes from `Connect` to `Disconnect`, confirming the account is linked.

What You Can Do

Once connected, Conversational Search can use the Google Calendar connector to query your schedule, take actions, and enrich answers with calendar context.

Feature Example prompt
View your schedule "What's on my calendar this week?"
Inspect an event "Show me the attendees, location, and description for my 2pm standup tomorrow."
Search events "Find my most recent 1:1 with Alice."
Create an event "Schedule a 30-minute sync with alice@example.com next Tuesday at 2pm and add a Google Meet link."
Create an all-day event "Block Friday as an all-day focus day on my work calendar."
Reschedule "Move my 3pm Friday meeting to Monday at 10am and notify attendees."
Update event details "Add bob@example.com to my 4pm sync and update the description with the new agenda."
Cancel an event "Cancel my 10am standup tomorrow and send cancellation emails."
Check availability "When am I free for a 45-minute meeting this week?"
Scope to one account "Show this week's events on my work calendar, not personal."
Query a shared calendar "What's on the team calendar for next Monday?"
Combine with workflow context "Summarize what I worked on during yesterday's 1:1 with Alice."
Deleting an event is permanent. Pieces will always confirm before cancelling an event on your behalf.

Using Calendar Context in Conversational Search

Beyond direct calendar management, Pieces uses your calendar to enrich answers.

  • Check availability before suggesting meeting times.
  • Provide context about upcoming or recent meetings when answering questions.
  • Cross-reference calendar events with activity captured by Long-Term Memory.

Calendar Context in Summaries

Once connected, your calendar events flow into Single-Click Summaries that use workflow context, including Morning Brief, Standup Update, and Day Recap. These summaries reflect what was actually on your schedule rather than what happened to be visible on your screen.

The Google Calendar connector is also the foundation for Meeting Prep, a summary type that looks ahead at your upcoming meetings, cross-references each event with your Long-Term Memory, and generates a structured pre-read.

Example prompts:

  • "When am I free for a 45-minute meeting this week?"
  • "Summarize what I worked on during yesterday's 1:1 with Alice."
  • "Move my 3pm to Friday morning and let the attendees know."

Managing Connected Accounts

You can connect multiple Google accounts and manage them from the connector's management screen.

Google Calendar Manage modal showing connected accounts and add account option

Google Calendar Manage modal showing connected accounts, reconnect options, and add account button

In the Pieces Desktop App, open `Settings` and select `Connectors`. Click the `Manage` button next to *Google Calendar* to open the management modal. The modal shows your **Connected Accounts** count and lists each linked account. You can also see accounts under **Needs Attention** if they've been disconnected and require reconnection.

Adding Another Account

Connect additional Google accounts to access multiple calendars.

Click `Manage` next to *Google Calendar* in Connectors settings. Click `+ Add account` in the Connected Accounts section. Complete the OAuth flow for the additional Google account.

Reconnecting a Disconnected Account

If an account appears under Needs Attention, you can reconnect it.

Click `Manage` next to *Google Calendar* in Connectors settings. Look under **Needs Attention** for accounts showing "Disconnected" status. Click the `Reconnect` button next to the account to re-authorize access.

Disconnecting an Account

Remove access for a specific Google account.

Click `Manage` next to *Google Calendar* in Connectors settings. Locate the account you want to disconnect in the Connected Accounts list or Needs Attention section. Click the `trash icon` next to the account to disconnect it. Pieces revokes the OAuth token and stops accessing that account's calendar.

Limitations

The current release of the Google Calendar connector has the following limitations:

  • Invitation responses — Pieces cannot accept or decline invitations on your behalf.
  • Calendar settings — Pieces cannot manage calendar permissions or settings.
  • Recurring event rules — Pieces cannot create recurrence rules, though it can read individual instances of recurring events.

Next Steps

Learn more about how Google Calendar integrates with the rest of Pieces: