Google Workspace MCP Server

Connect your AI agent to Google Calendar. Check your schedule, find free time, create events, resolve conflicts, and plan your day without opening a browser.

MCP Server·4 sections·1 min read

productivityworkflow

Install Prompt

Paste this into Claude Code to set it up:

I want to add the Google Workspace MCP Server to my Claude Code setup.

IMPORTANT: Never use Read/Edit tools on ~/.claude.json. Use jq via Bash instead.

Prerequisites: You need Google Cloud OAuth credentials.
1. Go to console.cloud.google.com, create a project, and enable the Google Calendar API
2. Create OAuth 2.0 credentials (Desktop application type)
3. Note your Client ID and Client Secret

Run this command to add the MCP server (replace the placeholder values with your actual credentials):
```bash
jq '.mcpServers["google-workspace"] = {"type": "stdio", "command": "npx", "args": ["-y", "@anthropic/google-calendar-mcp"], "env": {"GOOGLE_CLIENT_ID": "your-client-id", "GOOGLE_CLIENT_SECRET": "your-client-secret"}}' ~/.claude.json > /tmp/claude-json-tmp && mv /tmp/claude-json-tmp ~/.claude.json
```

After adding, restart Claude Code. On first use, the server triggers an OAuth browser flow where you grant calendar access. Subsequent sessions reuse the stored credentials.

01What It Does

The temporal backbone of your agent workflow

Calendar access is foundational because it gives your agent awareness of the dimension of time in your life. Without it, the agent cannot know when you are free, when you have commitments, or where scheduling conflicts exist. Combined with Todoist, this gives the agent awareness of both what you need to do and when you can do it.

📋

View and Manage EventsList events with date ranges, get full event details, create new events with attendees and descriptions, update or delete existing events.

⏰

Find Free TimeIdentify available time slots across all your calendars. The agent avoids double booking and respects existing commitments automatically.

02Real Scenarios

"What does my day look like?"

The agent summarizes today's meetings, identifies free blocks, flags conflicts and back-to-back meetings, and gives you a clean overview in seconds.

"Schedule a 30 minute meeting next week"

The agent finds available slots using find_free_time, presents options, and creates the event once you pick a time.

"My 2 PM conflicts with the deploy window"

The agent finds alternative times, presents options, and updates the event. One sentence from you; the agent handles the logistics.

"Block 2 hours for deep work tomorrow"

The agent checks tomorrow's calendar, creates a focus event in the best available slot, and optionally creates a matching Todoist task.

03Setup

Create Google Cloud Credentials

Go to console.cloud.google.com, create a project, enable the Google Calendar API, and create OAuth 2.0 credentials (Desktop application type).

Add to Config

Add the STDIO config to ~/.claude.json with your Client ID and Client Secret as environment variables.

Authorize on First Use

The server triggers an OAuth browser flow where you grant calendar access. Subsequent sessions reuse the stored credentials.

On any tool error, call get_status first. This diagnostic checks authentication state, API connectivity, and token validity. Most issues surface immediately through this single command.

04Works Well With

✅

Todoist MCPCalendar for when, Todoist for what. Together they form the complete daily planning system with awareness of tasks and availability.

💬

Slack MCPNotify channels about scheduled events, send reminders, or update teams when meetings are rescheduled.

🐙

GitHub MCPCheck if deploy windows conflict with meetings, or create calendar blocks for planned releases.