Overview
Calendar MCP Server is a Model Context Protocol (MCP) server designed for Google Calendar integration, allowing AI assistants to manage Google Calendar events through natural language interactions.
To use the Calendar MCP Server, install it via Smithery or manually using npm, set up your Google Cloud Project, and configure the server with your Google API credentials.
- Create, retrieve, update, and delete calendar events. - List events within a specified time range. - Full integration with Google Calendar API. - Secure OAuth2 authentication.
- Automating event management through AI.
- Integrating Google Calendar with AI assistants for natural language processing.
- Streamlining team scheduling and event organization.
Add to your AI client
Use these steps to connect 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": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}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": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"gongrzhe-calendar-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gongrzhe-calendar-mcp-server-mcp-mirror"
]
}
}
}FAQ
Can I use this server without a Google account?
No, you need a Google account to access Google Calendar API.
Is the Calendar MCP Server free to use?
Yes, the server is free to use, but you may incur charges from Google Cloud services.
How do I secure my API credentials?
Keep your credentials secure, rotate refresh tokens regularly, and do not share them in public repositories.