home / mcp / google calendar mcp server

Google Calendar MCP Server

Provides Google Calendar integration with OAuth 2.0, enabling calendar and event management via MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "am2rican5-mcp-google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-calendar"
      ],
      "env": {
        "PORT": "3420",
        "CREDENTIALS_PATH": "./credentials.json"
      }
    }
  }
}

You can run a TypeScript-based MCP server that integrates with Google Calendar to manage calendars and events from your AI assistants or MCP-enabled clients. It handles OAuth 2.0 authentication, persists tokens, and supports real-time updates via SSE if you enable it.

How to use

Start the server from your shell using a standard MCP client workflow. By default, you run the server with a simple command that launches the MCP server locally and connects to Google Calendar using stored credentials.

To use real-time updates, start with Server-Sent Events (SSE). This keeps you informed of calendar changes as they happen.

How to install

Prerequisites you need before installing:

• Node.js 16 or higher

• Google Cloud Platform account with Google Calendar API enabled

Install and run the server

npm install -g mcp-google-calendar
```

```
npx -y mcp-google-calendar

To run with Server-Sent Events (SSE), add the --sse option when starting the server.

Configuration and authentication

You will configure Google Cloud credentials and provide a path to the credentials file in your environment. The first run will prompt you to authorize access to Google Calendar in a browser window. The access token is saved for subsequent launches.

Environment variables you will use include the path to your OAuth credentials and the port your server will listen on.

Using with Claude Desktop or other MCP clients

Configure your client to point at this MCP server so you can control calendars and events from your assistant. Example environment variable setup for the client might provide the credentials path so the server can access Google Calendar.

Environment and security considerations

Keep credentials.json and token.json secure and do not commit them to version control. Each user should maintain their own OAuth credentials in Google Cloud Console. If you suspect credentials have been compromised, revoke them immediately.

Available tools and actions

The server exposes a set of calendar-focused commands you can invoke from MCP clients to manage calendars and events.

Available tools

list_calendars

Retrieve all available calendars from Google Calendar.

list_calendar_events

Fetch events between specified dates from a calendar.

create_calendar_event

Create a new event in a specified calendar.

get_calendar_event

Get details for a specific calendar event.

edit_calendar_event

Update an existing calendar event.

delete_calendar_event

Delete a calendar event from a calendar.