calendar-mcp-server
A community-built MCP server providing 23 tools for LLM agents to manage Google Calendar. It supports listing, searching, creating, updating, moving, RSVPing to, and deleting events. Features include free/busy queries, busyness analysis, recurring-event projection, and intelligent scheduling capabilities like finding mutual slots and booking focus time while respecting working hours and avoiding double-bookings.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 27 GitHub stars
What you can do with it
- List and search calendars and events
- Create, update, or delete calendar events
- Find free/busy time slots for scheduling
- Book focus time or mutual meeting slots
Source and maintenance
- Last repository push
- Latest release
- v1.1.1
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
calendar-mcp-server 1.0.1
{
"version": "1.0.1",
"transport": "stdio",
"identifier": "calendar-mcp-server",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "GOOGLE_CLIENT_ID",
"isRequired": true,
"description": "OAuth 2.0 client ID for a Google Cloud project with the Google Calendar API enabled."
},
{
"name": "GOOGLE_CLIENT_SECRET",
"isRequired": true,
"description": "OAuth 2.0 client secret matching GOOGLE_CLIENT_ID."
},
{
"name": "TOKEN_FILE_PATH",
"default": ".gcp-saved-tokens.json",
"description": "Path to the saved OAuth token file written by 'calendar-mcp auth'."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"calendar-mcp-server": {
"command": "uvx",
"args": [
"calendar-mcp-server==1.0.1"
],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<YOUR_TOKEN_FILE_PATH>"
}
}
}
}Cline
{
"mcpServers": {
"calendar-mcp-server": {
"command": "uvx",
"args": [
"calendar-mcp-server==1.0.1"
],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<YOUR_TOKEN_FILE_PATH>"
}
}
}
}VS Code
{
"servers": {
"calendar-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"calendar-mcp-server==1.0.1"
],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<YOUR_TOKEN_FILE_PATH>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"calendar-mcp-server": {
"command": "uvx",
"args": [
"calendar-mcp-server==1.0.1"
],
"env": {
"GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<YOUR_TOKEN_FILE_PATH>"
}
}
}
}Let your agent find its tools
Find servers like calendar-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.