Google Calendar MCP Server
MCP server for Google Calendar integration
Overview
Google Calendar MCP Server is a server that provides integration with Google Calendar, allowing users to view, create, and manage calendar events through a standardized interface.
To use the server, set up a Google Cloud project with the Calendar API enabled, install the necessary dependencies, and authenticate using OAuth 2.0 credentials.
- List available calendars - List events from a calendar - Create new calendar events - Update existing events - Delete events
- Automating calendar event management for applications.
- Integrating calendar functionalities into chatbots or virtual assistants.
- Building custom applications that require calendar event handling.
Add to your AI client
Use these steps to connect Google Calendar MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"google-calendar-mcp-khryptorgraphics": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"google-calendar-mcp-khryptorgraphics": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"google-calendar-mcp-khryptorgraphics": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"google-calendar-mcp-khryptorgraphics": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-calendar-mcp-khryptorgraphics": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"google-calendar-mcp-khryptorgraphics": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-khryptorgraphics"
]
}
}
}FAQ
What are the prerequisites to use this server?
You need Node.js 16 or higher and a Google Cloud project with the Calendar API enabled.
How do I authenticate with Google Calendar?
The server will start an authentication process that opens a browser for OAuth authentication and saves the tokens securely.
What happens if my OAuth token expires?
You will need to re-authenticate if the app is in testing mode.