Google Calendar MCP Server

What does “Google Calendar” MCP Server do?

The Google Calendar MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact seamlessly with Google Calendar. This server allows AI agents to access, manage, and manipulate calendar data, making it possible to list events from multiple calendars, create or update events, handle recurring events, check user availability, and even add events from non-standard sources like images or web links. By providing a bridge between AI systems and Google Calendar, it empowers developers to automate scheduling, event management, and availability queries, greatly enhancing productivity and workflow automation for teams and individuals alike.

List of Prompts

No explicit prompt templates are listed in the available documentation or repository files.

List of Resources

No explicit MCP “resources” are described in the documentation or repository files.

List of Tools

• List Events: Allows listing events from multiple Google Calendars at once.
• Create Event: Enables creation of new events on a user’s Google Calendar.
• Update Event: Permits updating details of existing calendar events.
• Delete Event: Removes events from a calendar.
• Search Events: Lets users search for specific calendar events.
• Free/Busy Query: Checks availability across calendars to find free or busy slots.
• Smart Scheduling: Uses natural language understanding to interpret date/time and schedule accordingly.
• Intelligent Import: Adds calendar events from images, PDFs, or web links.

Use Cases of this MCP Server

• Personal and Team Scheduling: Automate the creation, updating, and removal of events in Google Calendar, streamlining personal and collaborative scheduling.
• Meeting Coordination: Query free/busy status across multiple users or calendars to easily find mutually available meeting times.
• Event Management Automation: Enable AI agents to manage recurring events, update event details, and handle complex scheduling scenarios.
• Smart Event Importing: Parse event details from emails, images, PDFs, or web links and automatically add them to the calendar.
• AI-powered Reminders and Planning: Use natural language processing to set up reminders, schedule events, or plan days directly from chat with an AI assistant.

How to set it up

Windsurf

No setup instructions for Windsurf are provided in the repository.

Claude

1. Ensure you have a Google Cloud project with Calendar API enabled and OAuth 2.0 credentials (Desktop app type).
2. Locate your Claude Desktop configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Add the Google Calendar MCP server to the mcpServers section:

   {
     "mcpServers": {
       "google-calendar": {
         "command": "npx",
         "args": ["@cocal/google-calendar-mcp"],
         "env": {
           "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
         }
       }
     }
   }
   

4. Save the configuration file and restart Claude Desktop.
5. Verify the setup by attempting to query or create a calendar event.

Securing API Keys

• Use environment variables within your configuration as above (GOOGLE_OAUTH_CREDENTIALS).

Cursor

No setup instructions for Cursor are provided in the repository.

Cline

No setup instructions for Cline are provided in the repository.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "google-calendar": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “google-calendar” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

The Google Calendar MCP Server offers robust calendar management tools and clear setup for Claude. However, documentation is lacking for prompt templates, explicit MCP resources, and support for other platforms. If you need Google Calendar automation for AI agents, it’s a strong choice but would benefit from broader documentation and resource clarity.

MCP Score

Score: 6/10 — Strong tooling and setup for Claude, but missing docs for prompts, resources, and multi-platform support.