← Back to Google Calendar

Install Google Calendar

Pick your client, copy the command, done.

communication
Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/SamRind/gcal-mcp-server.git
cd gcal-mcp-server
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
2

Register it in Claude Code

claude mcp add -e "credentials.json=${credentials.json}" google-calendar -- python /path/to/gcal-mcp-server/server.py

Replace any placeholder paths in the command with the real path on your machine.

Required:credentials.json

Environment Variables

Set these before running Google Calendar.

VariableDescriptionRequired
credentials.jsonOAuth 2.0 credentials file downloaded from Google Cloud ConsoleYes

Available Tools (5)

Once configured, Google Calendar gives your AI agent access to:

list_eventsList upcoming events (default: next 7 days)
create_eventCreate a new calendar event
find_free_slotsFind available time slots
update_eventUpdate an existing event
delete_eventDelete/cancel an event

Try It Out

After setup, try these prompts with your AI agent:

→What do I have scheduled for the next 7 days?
→Create a new meeting titled 'Project Sync' for tomorrow at 2 PM.
→Find a free 30-minute slot for a meeting on Wednesday.
→Reschedule my 'Team Standup' meeting to Friday at 10 AM.
→Cancel my appointment with the dentist on Thursday.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • credentials.json — OAuth 2.0 credentials file downloaded from Google Cloud Console

Keep this setup from going cold

Save the docs, env vars, and workflow around Google Calendar in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← Google Calendar overview Browse communication servers →