Calendar MCP Server

A Model Context Protocol server for Google Calendar integration.

Setup

1. Clone the repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Get Google Calendar API Credentials:

   a. Create a Google Cloud Project:

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable the Google Calendar API for your project

   b. Create OAuth 2.0 Credentials:

   • Go to "APIs & Services" > "Credentials"
   • Click "Create Credentials" > "OAuth client ID"
   • Choose "Desktop app" as application type
   • Give it a name and click "Create"
   • You will get your GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET

   c. Get Refresh Token:

   • Go to OAuth 2.0 Playground
   • Click the gear icon (Settings) in the top right
   • Check "Use your own OAuth credentials"
   • Enter your OAuth Client ID and Client Secret
   • In the left panel, find "Calendar API v3" and select "https://www.googleapis.com/auth/calendar"
   • Click "Authorize APIs" and complete the OAuth flow
   • Click "Exchange authorization code for tokens"
   • Copy the "Refresh token" - this is your GOOGLE_REFRESH_TOKEN

5. Configure in Claude Desktop:

{
  "calendar": {
    "command": "node",
    "args": [
      "--no-deprecation",
      "PATH_TO_BUILD/index.js"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

Security Notes

• Keep your Google API credentials secure
• Regularly rotate your refresh tokens
• Store sensitive information in Claude Desktop configuration
• Never share or commit your credentials to version control
• The refresh token gives access to your Google Calendar, treat it like a password