Google Calendar

Provides Google Calendar event creation via MCP with OAuth-based authentication.

javascript

0

GitHub Stars

javascript

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": {
    "nkriman-mcp-google-calendar-server": {
      "command": "node",
      "args": [
        "/Users/krilet/mcp-google-calendar-server/src/index.js"
      ]
    }
  }
}

This MCP server lets you create Google Calendar events from your models and data. It provides two practical tools to authenticate with Google Calendar and to generate events directly in your calendar, streamlining your workflows when you need to schedule meetings, deadlines, or reminders from your context.

How to use

You will use two tools in your MCP client to interact with Google Calendar. First, authenticate Google Calendar to grant the server permission to manage your calendar. Then, create calendar events by supplying the event details you need. The server handles authorization once you complete the initial setup, and subsequent event creations will use the authorized access.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Install dependencies for the project.

npm install

Obtain Google Calendar API credentials. You will need a Google Cloud project with the Calendar API enabled and OAuth 2.0 Client ID credentials. Save the credentials file as credentials.json in the project root.

Authenticate with Google Calendar. Start the server and use the authenticate_google_calendar tool to generate the authorization URL. Open the URL in your browser, grant the requested permissions, and obtain the authorization code. Use that code to create token.json with your credentials.

Configure this MCP server in your MCP settings to enable the integration.

{
  "mcpServers": {
    "google_calendar": {
      "command": "node",
      "args": ["/Users/krilet/mcp-google-calendar-server/src/index.js"]
    }
  }
}

Additional configuration and notes

You will typically place credentials.json in the project root to authorize the Google Calendar access. token.json will be created after you complete the initial authorization flow. The MCP server will use these tokens to perform actions on your calendar.

This server exposes two tools to your MCP client: authenticate_google_calendar and create_calendar_event. You do not need to manually manage OAuth tokens after the initial setup; the server will refresh tokens as needed according to Google’s flow.

Security tip: keep credentials.json and token.json secure and limit access to the machine running the MCP server. Do not commit these files to version control.

Available tools

authenticate_google_calendar

Generates an authentication URL for Google Calendar access and initiates the OAuth flow.

create_calendar_event

Creates a new event in your Google Calendar using provided event details such as summary, start and end times, description, location, time zone, and attendees.