Google Calendar

A powerful Model Context Protocol (MCP) server that lets Claude interact with your Google Calendar seamlessly!

Transform Claude into your personal calendar assistant with full Google Calendar integration. Create meetings, check schedules, manage events, and more - all through natural conversation with Claude.

- 📋View all your calendars- See every calendar you have access to
- 📅Check your schedule- Get today's events or upcoming events for any timeframe
- 🎯Create meetings instantly- Set up Google Meet events with attendees
- ❌Cancel events- Remove events you no longer need
- 🔍Search events- Find events within specific date ranges

- "What meetings do I have today?"
- "Schedule a team standup for tomorrow at 10 AM with the engineering team"
- "Cancel my 3 PM meeting on Friday"
- "What's my schedule looking like next week?"
- "Create a Google Meet for our client review next Tuesday"

- Python 3.8 or higher
- A Google account with Calendar access
- Nango account for authentication (handles Google OAuth for you)

# Clone or download the MCP server files git clone <your-repo-url> cd google-calendar-mcp # Install required packages uv sync

Create a.envfile in the project directory:

# Copy the example file cp .env.example .env

# Required Nango Configuration NANGO_NANGO_BASE_URL=https://api.nango.dev NANGO_NANGO_SECRET_KEY=your_nango_secret_key_here NANGO_CONNECTION_ID=your_connection_id_here NANGO_INTEGRATION_ID=your_integration_id_here

🔧 Need help with Nango setup?Check theNango Setup Guidebelow!

{ "mcpServers": { "google-calendar": { "command": "uvx", "args": ["git+https://github.com/Shameerpc5029/google-calendar-mcp.git"], "env": { "NANGO_NANGO_BASE_URL": "https://api.nango.dev", "NANGO_NANGO_SECRET_KEY": "your_nango_secret_key_here", "NANGO_CONNECTION_ID": "your_connection_id_here", "NANGO_INTEGRATION_ID": "your_integration_id_here" } } } }

- Restart Claude Desktopcompletely
- Start a new conversationwith Claude
- Ask Claude:"What meetings do I have today?"

If everything is set up correctly, Claude will be able to access your Google Calendar! 🎉

Nango handles the complex Google OAuth flow for you. Here's how to set it up:

- Go toNango.devand sign up
- Create a new project

# Test that your environment is set up correctly python -c "import os; print('✅ All env vars set!' if all([os.getenv('NANGO_CONNECTION_ID'), os.getenv('NANGO_INTEGRATION_ID'), os.getenv('NANGO_NANGO_SECRET_KEY')]) else '❌ Missing env vars')"

# Install the MCP inspector npm install -g @modelcontextprotocol/inspector # Test your server npx @modelcontextprotocol/inspector python main.py

# Run the server directly to see if it starts without errors python main.py

Ask Claude:"Can you check what calendar tools are available?"

❌ "Failed to retrieve calendars"

- Check your Nango credentials in.env
- Verify your Google Calendar connection in Nango dashboard
- Ensure the Google account has calendar access

❌ "NANGO_CONNECTION_ID environment variable is required"

- Make sure your.envfile is in the same directory as the Python script
- Check that all environment variables are set correctly
- Restart Claude Desktop after making changes

❌ Claude can't find the calendar tools

- Verify the full path in your Claude config is correct
- Make sure you restarted Claude Desktop completely
- Check the Claude Desktop logs for error messages
- Check the logs: Claude Desktop shows MCP server logs in its developer console
- Test your .env: Runpython -c "from dotenv import load_dotenv; load_dotenv(); import os; print(os.environ.get('NANGO_CONNECTION_ID'))"
- Verify file paths: Make sure all paths in your Claude config are absolute paths

Once set up, you can have natural conversations with Claude about your calendar:

You:"What's my schedule looking like today?"

Claude:I'll check your calendar for today's events.

{ "success": true, "events": [ { "summary": "Team Standup", "start": "2024-01-15T09:00:00Z", "end": "2024-01-15T09:30:00Z" } ], "total_events": 1 }

You have 1 event today: Team Standup from 9:00 AM to 9:30 AM.

You:"Schedule a client meeting for next Friday at 2 PM withjohn@company.com"

{ "success": true, "event": { "summary": "Client Meeting", "start": "2024-01-19T14:00:00Z", "attendees": [{"email": "john@company.com"}] } }

✅ Created "Client Meeting" for Friday, January 19th at 2:00 PM withjohn@company.com. Google Meet link has been included automatically.

Interact with Google Calendar to list events, create meetings, and find free time slots.