v-3/google-calendar

This MCP server allows Claude to interact with your Google Calendar, enabling capabilities like listing events, creating meetings, and finding free time slots.
Prerequisites
- Node.js (v16 or higher)
- Claude Desktop App
- A Google Cloud Project
- Google Calendar API enabled
- OAuth 2.0 credentials
Setup Instructions
1. Create a Google Cloud Project
1. Go to the Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Calendar API:
- Go to "APIs & Services" > "Library"
- Search for "Google Calendar API"
- Click "Enable"
2. Configure OAuth Consent Screen
1. Go to "APIs & Services" > "OAuth consent screen"
2. Select "External" user type (unless you have a Google Workspace organization)
3. Fill in the required information:
- App name
- User support email
- Developer contact information
4. Add the following scopes:
- https://www.googleapis.com/auth/calendar
- https://www.googleapis.com/auth/calendar.events
5. Add your email address as a test user
3. Create OAuth 2.0 Credentials
1. Go to "APIs & Services" > "Credentials"
2. Click "Create Credentials" > "OAuth client ID"
3. Select "Desktop app" as the application type
4. Name your client (e.g., "MCP Calendar Client")
5. Click "Create"
6. Download the client configuration file (you'll need the client ID and client secret)
4. Get Refresh Token
1. Create a new file named getToken.js:
2. Install required dependency:
3. Update the script with your OAuth credentials:
- Replace your-client-id with your actual client ID
- Replace your-client-secret with your actual client secret
4. Run the script:
5. Follow the instructions in the console:
- Copy the provided URL
- Paste it into your browser
- Complete the Google authentication process
- Copy the refresh token that appears in the console
5. Configure Claude Desktop
1. Open your Claude Desktop configuration file:
**For MacOS:**
**For Windows:**
2. Add or update the configuration:
3. Save the file and restart Claude Desktop
Initial Project Setup
1. Create a new directory for your project:
2. Initialize a new npm project:
3. Install dependencies:
4. Create a tsconfig.json file:
5. Update package.json:
6. Create your source directory:
7. Create a .env file for local development (don't commit this file):
Building and Running
1. Build the server:
2. The server will automatically start when you open Claude Desktop
Available Tools
The server provides the following tools:
1. list_events: List calendar events within a specified time range
2. create_event: Create a new calendar event
3. update_event: Update an existing calendar event
4. delete_event: Delete a calendar event
5. find_free_time: Find available time slots in the calendar
Example Usage in Claude
After setup, you can use commands like:
- "Show me my calendar events for next week"
- "Schedule a meeting with [email_id] tomorrow at 2 PM for 1 hour"
- "Find a free 30-minute slot this afternoon"
- "Update my 3 PM meeting to 4 PM"
- "Cancel my meeting with ID [event_id]"