How to integrate Google Calendar MCP with Atomic Agent

Connect Atomic Agent to Google Calendar MCP. Create a meeting with the marketing team, list all events scheduled for next week, and more using natural language, with authentication handled for you.

Google Calendar logoGoogle Calendar
Oauth2

Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options.

47 Tools6 Triggers

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Google Calendar.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Google Calendar account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Google Calendar with

How Atomic Agent connects to Google Calendar

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Google Calendar to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Google Calendar. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Google Calendar account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Google Calendar MCP server, and what's possible with it?

The Google Calendar MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Calendar account. It provides structured and secure access to your calendars, events, availability, and sharing settings, so your agent can schedule meetings, find events, check availability, update plans, and manage calendars on your behalf.

  • Event scheduling and updates: Have your agent create events with set times or durations, change event details, and delete canceled plans.
  • Event search and review: Instruct your agent to find events by keywords or time range, retrieve event details, and review instances of recurring events.
  • Availability checks: Let the agent check busy periods across one or more calendars before arranging a meeting.
  • Calendar organization: Direct your agent to create, rename, update, delete, add, or remove calendars from your calendar list.
  • Calendar access management: Have your agent create, review, or remove calendar access rules to control sharing.

Use Google Calendar from Atomic Agent

With your account connected, ask Atomic Agent to work with Google Calendar in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Google Calendar action and event your agent gets out of the box.

Delete ACL Rule

Deletes an access control rule from a Google Calendar.

Get ACL Rule

Retrieves a specific access control rule for a calendar.

Create ACL Rule

Creates an access control rule for a calendar.

List ACL Rules

Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.

Patch ACL Rule

Partially updates the role or scope of an existing Google Calendar access control rule.

Update ACL Rule

Updates an access control rule for the specified calendar.

Watch ACL Changes

Tool to watch for changes to ACL resources.

Batch Events

Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results.

Remove Calendar from List

Removes a calendar from the user's calendar list, unsubscribing from it without deleting the calendar itself.

Get Single Calendar by ID

Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID.

Insert Calendar into List

Inserts an existing calendar into the user's calendar list, with optional display settings.

Patch Calendar List Entry

Updates an existing calendar on the user's calendar list using patch semantics.

Update Calendar List Entry

Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.).

Watch Calendar List

Creates a push-notification channel for changes to the user's calendar list.

Delete Calendar

Deletes a secondary calendar that you own or have delete permissions on.

Update Calendar

Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared.

Stop Channel

Tool to stop watching resources through a notification channel.

Clear Calendar

Clears a primary calendar by deleting all events from it.

Get Color Definitions

Returns the color definitions for calendars and events.

Create a new calendar

Creates a new secondary Google Calendar with the specified title and optional settings.

Create Event

Creates a timed or all-day Google Calendar event and returns it under response_data, without conflict checking.

Delete event

Deletes an event from the specified calendar.

Create a calendar

Creates a new, empty Google Calendar with the specified title (summary).

Get Event

Retrieves a SINGLE event by its unique event_id (REQUIRED).

Import Event

Tool to import an event as a private copy to a calendar.

Get Event Instances

Returns instances of the specified recurring event.

List Events

Lists or incrementally synchronizes events from one calendar, defaulting to the connected user's primary calendar.

List Events from All Calendars

Lists and deduplicates events across selected calendars or the user's calendar list for a time range.

Move Event

Moves a default event to another calendar, changing its organizer.

Watch Events

Watch for changes to Events resources.

Find event

Finds events in a specified Google Calendar using text, time ranges, and event types.

Find free slots

Queries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable.

Query Calendar Availability

Queries raw busy intervals for one or more calendars or groups over an exact time range.

Get Google Calendar

Gets canonical metadata for one Google Calendar, defaulting to the authenticated user's primary calendar.

Get current date and time

Gets the current date and time, allowing for a specific timezone offset.

Get Current Google Calendar User

Identifies the Google user connected to Calendar from the primary calendar resource.

List Buildings

Lists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names.

List Calendar Resources

Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API.

List Google Calendars

Lists calendars accessible through the connected user's CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders.

Patch Calendar

Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided.

Patch Event

Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar.

Quick Add Event

Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'.

Remove attendee from event

Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist.

Get Calendar Setting

Tool to return a single user setting for the authenticated user.

List Settings

Lists the authenticated user's calendar settings, returning a page of settings identified by their id fields.

Watch Settings

Watch for changes to Settings resources.

Update Google event

Replaces an existing Google Calendar event using its event ID and required start time.

FAQ

Frequently asked questions

Start with Google Calendar.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Calendar tool your agent needs.Free to start.

Start building