Skip to main content
Glama

MCP Server Setup

The server.js file contains the implementation of the Google Calendar MCP server.

Note: The MCP configuration may vary depending on the editor or MCP client you are using. The following instructions are for Cursor.

Prerequisites

Before configuring the MCP server, ensure you have:

  • Node.js installed

  • Cursor Editor installed and signed in

  • A Google Calendar API key

  • Your Google Calendar ID

Setup in Cursor

  1. Open Cursor.

  2. Go to Settings.

  3. Navigate to Tools → MCP.

  4. Add a new MCP server using the following configuration:

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "PATH_TO_SERVER_JS"
      ],
      "env": {
        "GOOGLE_PUBLIC_API_KEY": "YOUR_GOOGLE_API_KEY",
        "CALENDAR_ID": "YOUR_CALENDAR_ID"
      }
    }
  }
}

Configuration

Replace the placeholders below with your own values:

  • PATH_TO_SERVER_JS – Absolute path to the server.js file.

  • YOUR_GOOGLE_API_KEY – Your Google Calendar API key.

  • YOUR_CALENDAR_ID – Your Google Calendar ID (typically your Gmail address for your primary calendar).

After saving the configuration, restart Cursor (if required). Your MCP server will then be available for use.


Related MCP server: googlecalendar-mcp

Important Note

This project currently uses a Google Calendar API Key, which can only access public Google Calendars.

If your calendar is private, the server will not be able to retrieve event details such as the title, description, or attendees. To access private calendars or support creating, updating, and deleting events, you must replace the API key authentication with OAuth 2.0.

Current Features (API Key)

  • Read events from public Google Calendars

  • Retrieve events by date

  • Read private calendars

  • Create calendar events

  • Update calendar events

  • Delete calendar events

For full Google Calendar functionality, OAuth 2.0 authentication is recommended.

Resources

For a detailed guide on building custom MCP servers with TypeScript, check out the following article:

Available Tools

1 tool
getMyCalendarDataByDateD

Inputs: date (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of confusing between tools.

    Naming Consistency5/5

    With a single tool, naming consistency is inherently maintained.

    Tool Count2/5

    A Google Calendar server with only one tool is too few for its apparent scope, failing to cover basic operations.

    Completeness1/5

    The tool has no description and likely only fetches data by date, missing essential CRUD operations for a calendar service.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides integration with Google Calendar, allowing users to list calendars and manage events. It enables searching, creating, and modifying calendar entries through tools designed for the Model Context Protocol.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A Google Calendar MCP server built with FastMCP, providing tools for event CRUD, calendar management, and availability queries via the Google Calendar API.
      9
      MIT

    Appeared in Searches