Google Calendar MCP Server
Google Calendar MCP server for Claude Desktop integration
Overview
Google Calendar MCP Server is a Model Context Protocol (MCP) server implementation designed for integrating Google Calendar with Claude Desktop, allowing users to manage their calendar events seamlessly.
To use the Google Calendar MCP Server, you need to install it via npm, configure your Google Cloud Project with OAuth2 credentials, and set up the server in your Claude Desktop configuration.
- Manage Google Calendar events (get, create, update, delete) - OAuth2 authentication with Google Calendar API - Easy integration with Claude Desktop via MCP - Simple setup and configuration process
- Automating event management in Google Calendar for personal or business use.
- Integrating calendar functionalities into desktop applications.
- Streamlining scheduling processes for teams using Claude Desktop.
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-takumi0706": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}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-takumi0706": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}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-takumi0706": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}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-takumi0706": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-calendar-mcp-takumi0706": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"google-calendar-mcp-takumi0706": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar-mcp-takumi0706"
]
}
}
}FAQ
What is required to set up the Google Calendar MCP Server?
You need to create a Google Cloud Project, enable the Google Calendar API, and configure OAuth2 credentials.
Is there a specific environment setup needed?
Yes, you need to set up environment variables for your Google OAuth credentials in a .env file.
How are logs and tokens managed?
OAuth tokens are stored in `token.json`, and logs are saved in the user's home directory under `~/.google-calendar-mcp/logs/`.