# MCP Google Calendar Server

A Model Context Protocol (MCP) server for creating Google Calendar events.

## Setup

1. **Install dependencies:**
   ```bash
   npm install
   ```

2. **Get Google Calendar API credentials:**
   - Go to [Google Cloud Console](https://console.cloud.google.com/)
   - Create a new project or select existing one
   - Enable the Google Calendar API
   - Create credentials (OAuth 2.0 Client ID)
   - Download the credentials and save as `credentials.json` in the project root

3. **Authenticate:**
   - Run the server and use the `authenticate_google_calendar` tool to get the auth URL
   - Visit the URL, grant permissions, and get the authorization code
   - Create a `token.json` file with your credentials

4. **Configure Claude Code:**
   Add to your MCP settings:
   ```json
   {
     "mcpServers": {
       "google-calendar": {
         "command": "node",
         "args": ["/Users/krilet/mcp-google-calendar-server/src/index.js"]
       }
     }
   }
   ```

## Usage

The server provides two tools:

### `authenticate_google_calendar`
Generates an authentication URL for Google Calendar access.

### `create_calendar_event`
Creates a new event in your Google Calendar.

**Parameters:**
- `summary` (required): Event title
- `startDateTime` (required): Start time in ISO format
- `endDateTime` (required): End time in ISO format  
- `description` (optional): Event description
- `location` (optional): Event location
- `timeZone` (optional): Time zone (defaults to UTC)
- `attendees` (optional): Array of email addresses

**Example:**
```json
{
  "summary": "Team Meeting",
  "startDateTime": "2024-12-25T10:00:00-08:00",
  "endDateTime": "2024-12-25T11:00:00-08:00",
  "description": "Weekly team sync",
  "location": "Conference Room A",
  "attendees": ["colleague@example.com"]
}
```