Google Calendar MCP Server

What is Google Calendar MCP Server?

Google Calendar MCP Server provides access to your Google Calendar events and allows you to manage them through an MCP (Model Context Protocol) interface. It integrates with Google Calendar and is designed for use with Claude Desktop or any other MCP-compatible client.

How to use Google Calendar MCP Server?

Requires Python 3.10 or higher, a Google Cloud project with the Calendar API enabled, and OAuth credentials. Clone the repository, create a virtual environment, install dependencies (pip or uv), and place a credentials.json file in the project directory. Then configure your MCP client (e.g., Claude Desktop or Cursor) with the path to the virtual environment's mcp binary and the server script. On first use, a browser opens for Google OAuth authentication, and credentials are stored in token.json.

Key features of Google Calendar MCP Server?

• View calendar events for any date or range
• Create new events with title, time, description, and more
• Update existing events with new details
• Pre-built prompts for common calendar actions
• Exposes calendar events via MCP resources (calendar://events/{date})

Common use cases of Google Calendar MCP Server?

• Ask "Show me my events for today" to quickly view your daily schedule
• Create a meeting with a colleague by saying "Create a meeting with John tomorrow at 2pm"
• Update or reschedule an existing event via natural language commands
• Plan your week by requesting events for a date range
• Integrate calendar management into AI-powered workflows

FAQ from Google Calendar MCP Server

What Python version is required?

Python 3.10 or higher is required. Check your version with python --version and create a virtual environment accordingly.

How does authentication work?

On first use, the server opens a browser for Google OAuth authentication. After authorizing, credentials are stored in token.json for future use. You must have a valid credentials.json file from Google Cloud Console.

Where are my credentials and tokens stored?

The credentials.json file (downloaded from Google Cloud Console) must be placed in the project directory. Authentication tokens are stored in token.json after the first login.

What time zone does the server use?

The server uses UTC for timestamps. Event times are displayed in the local timezone of your system.

Can I use this server with Cursor?

Yes. In Cursor, go to Settings > MCP and add the server configuration with the same command and arguments used for Claude Desktop.