How to integrate Google Calendar MCP with Hermes

Connect Hermes 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.

Get started for free Get a demo

Google 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 Tools7 Triggers

Managed auth

Connect Google Calendar without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Google Calendar account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Google Calendar with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

Search and load tools from relevant toolkits on-demand, reducing context usage.
Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
Manage app authentication end-to-end with zero manual overhead.

Integrating Google Calendar with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash

curl -fsSL https://composio.dev/install | bash

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Google Calendar

Ask your agent to connect to Google Calendar, or simply request any Google Calendar-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Google Calendar connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash

nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash

mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Google Calendar or request any Google Calendar-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Google Calendar connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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

Updates an existing access control rule for a calendar using patch semantics (partial update).

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

Tool to remove a calendar from the user's calendar list.

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, making it visible in the UI.

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

Watch for changes to CalendarList resources using push notifications.

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 event using start_datetime and either end_datetime or duration fields, or an all-day event using an inclusive start_date and exclusive end_date.

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

Return a unified event list across all calendars in the user's calendar list for a given time range.

Move Event

Moves an event to another calendar, i.

Watch Events

Watch for changes to Events resources.

Find event

Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types.

Find free slots

Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range.

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 all buildings for a Google Workspace customer account with full details including 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

Returns all user settings for the authenticated user.

Watch Settings

Watch for changes to Settings resources.

Update Google event

Updates an existing event in Google Calendar.

FRAMEWORKS

How to build Google Calendar MCP Agent with another framework

Claude Code

Use Google Calendar MCP with Claude Code

Cursor

Use Google Calendar MCP with Cursor

ChatGPT

Use Google Calendar MCP with ChatGPT

Claude Cowork

Use Google Calendar MCP with Claude Cowork

Antigravity

Use Google Calendar MCP with Antigravity

OpenAI Agents SDK

Use Google Calendar MCP with OpenAI Agents SDK

Claude Agent SDK

Use Google Calendar MCP with Claude Agent SDK

Grok Bot

Use Google Calendar MCP with Grok Bot

Muse

Use Google Calendar MCP with Muse

Codex

Use Google Calendar MCP with Codex

Kimi Code

Use Google Calendar MCP with Kimi Code

Grok Build

Use Google Calendar MCP with Grok Build

VS Code

Use Google Calendar MCP with VS Code

OpenCode

Use Google Calendar MCP with OpenCode

OpenClaw

Use Google Calendar MCP with OpenClaw

Atomic Agent

Use Google Calendar MCP with Atomic Agent

CLI

Use Google Calendar MCP with CLI

Google ADK

Use Google Calendar MCP with Google ADK

LangChain

Use Google Calendar MCP with LangChain

Vercel AI SDK

Use Google Calendar MCP with Vercel AI SDK

Mastra AI

Use Google Calendar MCP with Mastra AI

LlamaIndex

Use Google Calendar MCP with LlamaIndex

CrewAI

Use Google Calendar MCP with CrewAI

Pydantic AI

Use Google Calendar MCP with Pydantic AI

AutoGen

Use Google Calendar MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Apaleo

Oauth2

Apaleo is a cloud-based property management platform for hospitality businesses. It centralizes reservations, billing, and daily operations for smoother hotel management.

Appointo

Api Key

Appointo is an appointment booking platform for Shopify stores. It lets businesses add online scheduling to their websites with zero coding.

Bart

Api Key

Bart is the Bay Area Rapid Transit system, providing fast public transportation across the San Francisco Bay Area. It helps commuters and travelers get real-time schedule info, plan routes, and stay updated on service changes.

Blue Pillow Hotels & Stays

Api Key

Blue Pillow Hotels & Stays is a hotel and stay discovery platform offering live offers, recommendations, and booking handoff. It helps surface and compare real-time deals and validate bookings for smoother reservations.

FAQ

Frequently asked questions

With a standalone Google Calendar MCP server, the agents and LLMs can only access a fixed set of Google Calendar tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Calendar and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Calendar tools.

Yes, absolutely. You can configure which Google Calendar scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Calendar data and credentials are handled as safely as possible.

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

How to integrate Google Calendar MCP with Hermes

Connect Google Calendar without auth hassles

Introduction

Also integrate Google Calendar with

What is Composio Connect?

Integrating Google Calendar with Hermes

Using Composio Connect CLI

Using Composio Connect MCP

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

Way Forward

Supported Tools and Triggers

How to build Google Calendar MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Grok Bot

Muse

Codex

Kimi Code

Grok Build

VS Code

OpenCode

OpenClaw

Atomic Agent

CLI

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Apaleo

Appointo

Bart

Blue Pillow Hotels & Stays

Frequently asked questions

What are the differences in Tool Router MCP and Google Calendar MCP?+

Can I use Tool Router MCP with Hermes?+

Can I manage the permissions and scopes for Google Calendar while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Google Calendar.It takes 30 seconds.