MCP Google Calendar Server
A Model Context Protocol (MCP) server implementation for Google Calendar integration. Create and manage calendar events directly through Claude or other AI assistants.
Overview
MCP Google Calendar Server is a Model Context Protocol (MCP) server implementation that allows AI assistants like Claude to create and manage Google Calendar events efficiently.
To use this server, clone the repository, install the necessary dependencies, configure your Google OAuth2 credentials, and start the server to interact with Google Calendar through your AI assistant.
- Create calendar events complete with titles, descriptions, and start/end times. - Support for adding attendees to events. - Utilizes secure OAuth2 authentication with Google Calendar API. - Full implementation of the MCP protocol. - Includes debug logging for easier troubleshooting.
- Automating event creation through AI assistants.
- Managing personal and professional schedules more effectively.
- Integrating calendar functionalities into various applications powered by AI.
Add to your AI client
Use these steps to connect MCP Google Calendar 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": {
"mcp-google-calendar-markelaugust74": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}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": {
"mcp-google-calendar-markelaugust74": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-google-calendar-markelaugust74": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-google-calendar-markelaugust74": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-google-calendar-markelaugust74": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-google-calendar-markelaugust74": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-google-calendar-markelaugust74"
]
}
}
}FAQ
What are the requirements for using MCP Google Calendar Server?
You need Node.js v18 or later, a Google Cloud Console project with the Calendar API enabled, and OAuth2 credentials.
How do I authenticate my application with Google Calendar?
You will need to set up OAuth2 credentials and obtain a refresh token through the provided script.
Can I use this project with any AI assistant?
Yes! While it is designed for Claude, it can be integrated with other compatible AI assistants as well.