https://github.com/cnayan/minimal-google-calendar-mcp-server
Minimal Google Calendar MCP Server
https://github.com/cnayan/minimal-google-calendar-mcp-server
Last synced: 9 months ago
JSON representation
Minimal Google Calendar MCP Server
- Host: GitHub
- URL: https://github.com/cnayan/minimal-google-calendar-mcp-server
- Owner: cnayan
- License: mit
- Created: 2025-07-30T07:57:13.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-30T08:21:18.000Z (12 months ago)
- Last Synced: 2025-07-30T10:34:47.258Z (12 months ago)
- Language: Python
- Size: 158 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://developers.google.com/workspace/calendar/api/quickstart/python)
- Download the client secret JSON and keep in the repo base folder as `credentials.json`
### Run MCP Server
```cmd
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:
```json
"gcal-mcp": {
"command": ,
"args": [
"--directory",
,
"run",
"src\\tool.py"
]
}
```
It may look like this finally:
```json
{
"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/