google-calendar

Google Calendar MCP Server

This MCP server integrates with Google Calendar to provide functions such as listing events, scheduling meetings, and finding free time slots. It requires Node.js, the Claude Desktop App, and a Google Cloud Project with the Google Calendar API enabled.

Prerequisites

• Node.js (v16 or higher)
• Claude Desktop App
• Google Cloud Project
• Google Calendar API enabled
• OAuth 2.0 credentials

Available Tools

• list_events: List events within a specific time range
• create_event: Create a new calendar event
• update_event: Update an existing event
• delete_event: Delete an event
• find_free_time: Find available time slots in the calendar

Example Usage in Claude

• "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]"

Troubleshooting

Common Issues

1. Tools not appearing in Claude: Check Claude Desktop logs, verify environment variables, ensure the correct path to index.js.
2. Authentication Errors: Verify OAuth credentials, check if the refresh token is valid, ensure required scopes are enabled.
3. Server Connection Issues: Verify if the server built successfully, check file permissions on build/index.js.

Security Considerations

• Keep OAuth credentials secure
• Avoid committing credentials to version control
• Use environment variables for sensitive data
• Regularly rotate refresh tokens
• Monitor API usage in Google Cloud Console