Google Calendar

by am2rican5

1.1k downloads

Not rated

GitHub

About

Integrates with Google Calendar API for managing calendars and events with persistent OAuth token storage, enabling seamless scheduling, retrieval, and modification operations without repeated authentication.

Details

Author: am2rican5
Repository: am2rican5/mcp-google-calendar
Downloads: 1,074
License: MIT License
Categories: Productivity, Other, AI, Design, Developer Tools, File Management, Security, API
Tags: #integration

- Seamless Google Calendar integration with OAuth 2.0 authentication
- Persistent token storage for automatic authentication
- List and manage calendars with comprehensive event operations
- Create, read, update, and delete calendar events
- Fetch calendar events between specified dates
- Server-Sent Events (SSE) transport option for real-time updates
- Simple integration with Claude and other MCP-compatible AI assistants

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Google Calendar

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 mcp-google-calendar
Environment
- CREDENTIALS_PATH /path/to/your/credentials.json
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "mcp-google-calendar"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "mcp-google-calendar"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "mcp-google-calendar"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "mcp-google-calendar"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "mcp-google-calendar"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

From the repository

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Calendar API:
- Navigate to "APIs & Services" > "Library"
- Search for "Google Calendar API"
- Click "Enable"
4. Configure OAuth consent screen:
- Go to "APIs & Services" > "OAuth consent screen"
- Choose "External" user type (or "Internal" for Google Workspace)
- Fill in required information:
- App name: mcp-calendar
- User support email: (your email)
- Developer contact information: (your email)
- Add scopes:
- Click "Add or Remove Scopes"
- Find and select "https://www.googleapis.com/auth/calendar.events"
- Add your email as a test user
- Complete the setup
5. Create OAuth credentials:
- Go to "Credentials"
- Click "Create Credentials" > "OAuth Client ID"
- Choose "Desktop app" as application type
- Name it (e.g., "MCP Calendar Desktop Client")
- Download the JSON file and save as credentials.json in your project directory

Create a .env file in your project root:


PORT=3420
CREDENTIALS_PATH=./credentials.json

The first time you run the server:
1. A browser window will open automatically
2. Sign in with your Google account
3. Grant the requested calendar permissions
4. The authentication token is saved to token.json

On subsequent launches:
- The server uses the saved token automatically
- No browser interaction is required unless the token expires

`list_calendars`

Get all available calendars.

`list_calendar_events`

Retrieve events between specified dates.

`create_calendar_event`

Add a new event to your calendar.

`get_calendar_event`

Fetch details for a specific event.

`edit_calendar_event`

Modify an existing calendar event.

`delete_calendar_event`

Remove an event from your calendar.

| Tool | Description |
|------|-------------|
| list_calendars | Get all available calendars |
| list_calendar_events | Retrieve events between specified dates |
| create_calendar_event | Add a new event to your calendar |
| get_calendar_event | Fetch details for a specific event |
| edit_calendar_event | Modify an existing calendar event |
| delete_calendar_event | Remove an event from your calendar |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google calendar": {
            "env": {
                "CREDENTIALS_PATH": "/path/to/your/credentials.json"
            },
            "args": [
                "-y",
                "mcp-google-calendar"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "CREDENTIALS_PATH": "/path/to/your/credentials.json"
    },
    "args": [
        "-y",
        "mcp-google-calendar"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "CREDENTIALS_PATH": "/path/to/your/credentials.json"
    },
    "args": [
        "-y",
        "mcp-google-calendar"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "CREDENTIALS_PATH": "/path/to/your/credentials.json"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "mcp-google-calendar"
    ],
    "command": "cmd"
}

Google Calendar MCP Server

A Model Context Protocol (MCP) server that integrates with Google Calendar, built with TypeScript.

Features

Installation

npm install -g mcp-google-calendar

Or run directly with:

npx -y mcp-google-calendar

Prerequisites

1. Node.js (v16 or higher)
2. Google Cloud Platform account
3. Google Calendar API enabled
4. OAuth 2.0 credentials

Setup

1. Google Cloud Configuration

2. Environment Configuration

Create a .env file in your project root:

```

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_calendars

list_calendar_events

create_calendar_event

get_calendar_event

edit_calendar_event

delete_calendar_event

Claude Desktop / Cursor

Linux

Macos

Windows

Google Calendar MCP Server

Features

Installation

Prerequisites

Setup

1. Google Cloud Configuration

2. Environment Configuration

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

Context 7

`list_calendars`

`list_calendar_events`

`create_calendar_event`

`get_calendar_event`

`edit_calendar_event`

`delete_calendar_event`