mcp_server_google_calendar

This MCP server integrates with Google Calendar to help you manage events through natural language requests. You can ask it to create events based on your availability, or query your calendar to check free/busy times and schedule meetings. For example, you might say: “Create an event called ‘Chill’ on Monday after 8pm,” or “Check when both me and a teammate are free this week between 9am and 5pm and schedule a meeting called ‘Going over MCP’.” The server exposes capabilities to create events, list upcoming events, and check availability against a specified calendar. Use Claude to issue commands; the MCP server will translate your requests into Google Calendar API operations and return results that you can act on.

Prerequisites:

• Node.js v18.0.0 or newer
• Claude Desktop installed

MacOS/Linux/Windows (Windows notes: as of the current README, Windows installation is listed as coming soon; use MacOS/Linux workflows if possible):

1. Ensure Node.js is installed and accessible in your PATH. Verify with:

node -v
npm -v

2. Install and run the MCP server via npx (as shown in the README):

npx mcp-server-google-calendar init

3. Follow any additional setup prompts to configure Google Cloud credentials (the README notes that Google Cloud project setup/auth flow may require manual steps). Place your Google credentials (credentials.json) in a secure location and reference it via the environment variables described in the mcp_config. Restart Claude Desktop after configuration.

4. Start Claude Desktop if you haven't already, and test a simple query like:

Give me a list of all my events this week

Notes and tips:

• The server requires Google API credentials with access to Google Calendar. Keep credentials.json secure and avoid leaking it in logs.
• You may need to specify the calendar ID you want to operate on (GOOGLE_CALENDAR_ID).
• If you encounter authentication issues, ensure the OAuth scopes include calendar access (https://www.googleapis.com/auth/calendar) and that the credentials are loaded by the server at startup.
• The README mentions the initial setup steps for macOS; Windows and Linux usage may differ as per environment. If you run into platform-specific issues, consult the MCP server docs or adjust the npx invocation accordingly.
• If you plan to run this in production, consider mounting credentials securely and rotating them periodically.
• When using natural language commands, the MCP server will parse intent to either create events, list upcoming events, or check availability before scheduling.