Google Calendar MCP Server

Name: Google Calendar MCP Server
Author: 101ta28

@101ta28

Repository

About Google Calendar MCP Server

Google Calendar APIを使用したMCPサーバー

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-calendar-mcp-server-101ta28": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Calendar MCP Server?

It is a server that uses the Google Calendar API to allow an MCP client to search calendar contents. It requires a Google account, the uv tool, and OAuth 2.0 authentication.

How to use Google Calendar MCP Server?

Create a Google Cloud project with the Calendar API enabled, set up OAuth consent and desktop app credentials, then run uv sync and uv run generate_token.py to generate token.json. Configure calendar_settings.json with calendar IDs and set up the MCP client using the provided mcp.json example. Finally, enable Agent Mode in VS Code Copilot Chat and ask calendar queries.

Key features of Google Calendar MCP Server

Searches Google Calendar via MCP stdio transport
Uses OAuth 2.0 desktop authentication flow
Supports multiple calendars via calendar_settings.json
Integrates with VS Code Copilot Chat Agent Mode
First‑use browser authorization for token generation

Use cases of Google Calendar MCP Server

Ask "List the events for April 8th" in a Copilot Chat
Search work schedule using a configured work calendar ID
Retrieve primary calendar events without leaving the editor

FAQ from Google Calendar MCP Server

What are the prerequisites?

You need a Google account, uv installed, and a Google Cloud project with the Calendar API enabled.

How do I configure multiple calendars?

Edit calendar_settings.json to map calendar names like primary and work to their Google Calendar IDs, then rename the file from .sample to .json.

What should I do if an error occurs?

Check the error message and, if necessary, reinstall dependencies or verify your Google Cloud Console settings.

How does authentication work?

You generate a token.json by running uv run generate_token.py and granting permission in your browser. On first MCP use, the browser will again request access.