minimal-google-calendar-mcp-server

cnayan/minimal-google-calendar-mcp-server

3.2

If you are the rightful owner of minimal-google-calendar-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Google Calendar Events MCP Server is designed to interface with Google Calendar API to fetch and display upcoming events.

Google Calendar Events MCP Server

Uses Google Calendar API method to fetch upcoming events only.

Test output:

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/