Minimal Google Calendar

FreeNot checked

Minimal Google Calendar MCP Server

by cnayan

GitHub Embed

About

Minimal Google Calendar MCP Server

README

Uses Google Calendar API method to fetch upcoming events only.

Test output:

Sample output from the MCP server for calendar events

Pre-requisites

Create an app on GCP and get client secret.

Set up your Google Workspace project and Auth Platform by following Google's documentation
Download the client secret JSON and keep in the repo base folder as credentials.json

Run MCP Server

uv venv
uv sync
uv run src/tool.py

Add to Claude Desktop [Windows Setting]

Note: You must have it installed.

Open file in Notepad: %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json

Add the MCP server entry to the JSON:

"gcal-mcp": {
    "command": <PATH TO uv.exe>,
    "args": [
        "--directory",
        <PATH TO THE MCP SERVER FOLDER>,
        "run",
        "src\\tool.py"
    ]
}

It may look like this finally:

{
	"mcpServers": {
		"gcal-mcp": {
			"command": "%USERPROFILE%\\Miniconda3\\Scripts\\uv.exe",
			"args": [
				"--directory",
				"E:\\Dev\\mcp\\servers\\gcal",
				"run",
				"src\\tool.py"
			]
		}
	}
}

It should look like this in Claude Desktop

Note

I use Miniconda. Hence the path to UV shows up this way. If you have different setup, you will have to figure out where UV.exe is installed.
UV setup guide: https://docs.astral.sh/uv/getting-started/installation/

from github.com/cnayan/minimal-google-calendar-mcp-server

Install Minimal Google Calendar in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install minimal-google-calendar

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add minimal-google-calendar -- uvx gcal-mcp

Step-by-step: how to install Minimal Google Calendar

Install Minimal Google Calendar in Claude Desktop Install Minimal Google Calendar in Claude Code Install Minimal Google Calendar in Cursor Install Minimal Google Calendar in VS Code

FAQ

Is Minimal Google Calendar MCP free?

Yes, Minimal Google Calendar MCP is free — one-click install via Unyly at no cost.

Does Minimal Google Calendar need an API key?

No, Minimal Google Calendar runs without API keys or environment variables.

Is Minimal Google Calendar hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Minimal Google Calendar in Claude Desktop, Claude Code or Cursor?

Open Minimal Google Calendar on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Notion

Read and write pages in your workspace

by Notion

Linear

Issues, cycles, triage — from Claude

by Linear

Pro

Google Drive

Search and read your Drive files

by Google

mindsdb/mindsdb

Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).

by mindsdb

fulcradynamics/fulcra-context-mcp

MCP server for accessing personal health and biometric data including sleep stages, heart rate, HRV, glucose, workouts, calendar, and location via the Fulcra Li

by fulcradynamics

aymericzip/intlayer

A MCP Server that enhance your IDE with AI-powered assistance for Intlayer i18n / CMS tool: smart CLI access, access to the docs.

by aymericzip

rinadelph/Agent-MCP

A framework for creating multi-agent systems using MCP for coordinated AI collaboration, featuring task management, shared context, and RAG capabilities.

by rinadelph

WhenLabs-org/when

Developer toolkit: auto-detect stack for AI context files, catch port conflicts, validate .env schemas, spot docs drift, audit dependency licenses, and time cod

by WhenLabs-org

Beltran12138/wecom-docs-mcp-server

WeCom (Enterprise WeChat) document operations via MCP: create, read, and edit Docs and Smartsheets (9 tools). Fills the doc-CRUD gap — existing WeCom MCP server

by Beltran12138

madbonez/caldav-mcp

Universal MCP server for CalDAV protocol integration. Works with any CalDAV-compatible calendar server including Yandex Calendar, Google Calendar (via CalDAV),

by madbonez

Compare Minimal Google Calendar with

Minimal Google CalendarvsNotion Minimal Google CalendarvsLinear Minimal Google CalendarvsGoogle Drive Minimal Google Calendarvsmindsdb/mindsdb Minimal Google Calendarvsfulcradynamics/fulcra-context-mcp Minimal Google Calendarvsaymericzip/intlayer Minimal Google Calendarvsrinadelph/Agent-MCP Minimal Google CalendarvsWhenLabs-org/when Minimal Google CalendarvsBeltran12138/wecom-docs-mcp-server Minimal Google Calendarvsmadbonez/caldav-mcp

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All productivity MCPs