Google Calendar MCP Server

Fit and risk

Setup

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

{
  "servers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

claude mcp add google-calendar -e GOOGLE_OAUTH_CREDENTIALS=/path/to/your/gcp-oauth.keys.json -- npx @cocal/google-calendar-mcp

Check that it works

After starting the client, ask it to "Authenticate with Google Calendar" to complete the OAuth flow, then check that tools like list-calendars, list-events, and create-event appear; asking the AI to run list-calendars and return your calendars proves the connection works.

Troubleshooting

1. Ensure GOOGLE_OAUTH_CREDENTIALS points to a valid credentials file
2. Verify credentials are for 'Desktop app' and test user is added
3. Re-authenticate by running npm run auth or npx @cocal/google-calendar-mcp auth
4. Check that ports 3500-3505 are not blocked, as they are used for authentication
5. Ensure credentials file includes project_id to avoid rate limit errors

Things to try

Once connected, you can ask your AI assistant things like:

• What events do I have coming up this week that aren't part of my usual routine?Copy
• Create a meeting on my calendar for tomorrow at 2pm.Copy
• Which events tomorrow have attendees who have not accepted the invitation?Copy
• Accept the team meeting invitation on my calendar for tomorrow at 2pm.Copy

Tools 12

No matching tools

Use cases

Supported clients

Listed from the project's documentation, not tested by this site.

Overview

Similar servers