mcpField
M
MCP Google Calendar Server

MCP Google Calendar Server

Local
github.com/tobedoitProductivity3Updated 36w ago

About MCP Google Calendar Server

MCP Google Calendar Server is an MCP server for AI assistants to create and manage Google Calendar events, including attendee support and OAuth2 authentication.

Key features

  1. 01Create events with times and alerts
  2. 02Add event attendees
  3. 03Authenticate with Google Calendar via OAuth2
  4. 04Use debug logging

Use cases

  1. 01Schedule events with titles, descriptions, and times
  2. 02Invite attendees to calendar events

MCP support

The server exposes Google Calendar event creation and management to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"gCalendar": {
"command": "npx",
"args": [
"-y",
"@tobedoit/google-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>"
}
}
}
}
Run commandnpx -y @tobedoit/google-calendar-mcp
Environment variables to set
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRETSecret
GOOGLE_REFRESH_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@tobedoit/google-calendar-mcp

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
summarystringYesEvent title
end_timestringYesEnd time (ISO format)
locationstringNoEvent location
attendeesarrayNoList of attendee emails
remindersobjectNoReminder settings for the event
reminders.overridesarrayNoList of custom reminder settings
reminders.useDefaultbooleanNoWhether to use default reminders
start_timestringYesStart time (ISO format)
descriptionstringNoEvent description

Details

From the project README

MCP Google Calendar Server

npm license

A Model Context Protocol (MCP) server implementation that enables AI assistants like Claude to create and manage Google Calendar events.

Features

  • Create calendar events with title, description, start/end times, and alert
  • Support for adding event attendees
  • OAuth2 authentication with Google Calendar API
  • Full MCP protocol implementation
  • Debug logging for troubleshooting

Prerequisites

  • Node.js v18 or later
  • Google Cloud Console project with Calendar API enabled
  • OAuth2 credentials (Client ID and Client Secret)

Setup

Paste Claude "claude_desktop_config.json"

{
  "mcpServers": {
    "zmes-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@tobedoit/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_google_client_id",
        "GOOGLE_CLIENT_SECRET": "your_google_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_google_refresh_token"
      }
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.