MCP server for Google Calendar

Provides an MCP interface to securely interact with Google Calendar data via a service account.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "despinozap-mcpserver_google-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_CALENDAR_ID",
        "mcpserver-googlecalendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_ID": "[CALENDAR_ID_HERE]"
      }
    }
  }
}

You can run an MCP server that interfaces with Google Calendar using a service account, enabling you to interact with calendars through a consistent MCP interface and Docker-based deployment.

How to use

To interact with Google Calendar via MCP, you will run the Google Calendar MCP server as a local Docker-based process. You provide the target Google Calendar ID through an environment variable and the server exposes an MCP endpoint that you can consume from your MCP client. Before you start, make sure the calendar is shared with the service account email you generate during setup.

How to install

Prerequisites you need before installing and running the server:

Node.js and npm installed on your machine.

1) Build and package the MCP server

{
  "mcpServers": {
    "google_calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_CALENDAR_ID",
        "mcpserver-googlecalendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_ID": "[CALENDAR_ID_HERE]"
      }
    }
  }
}

2) Run the build steps and create the Docker image

Build the MCP server locally to prepare the Docker image that will be used at runtime.

npm run build
docker build -t mcpserver-googlecalendar .

Available tools

inspector

Debug the MCP server during development using npm run inspector.

build

Assemble the project into a Docker image ready for deployment.

docker-run

Execute the Docker container that runs the MCP server with the required environment variables.