# google-calendar-mcp

MCP server for Google Calendar and Google Tasks, exposed over HTTP (JSON-RPC) so LLM clients can manage events and tasks via a service account.

## Tools

| Tool | Description |
|------|-------------|
| `list_events` | List upcoming calendar events |
| `create_event` | Create an event (recurring, all-day, reminders, colors) |
| `update_event` | Update an existing event |
| `delete_event` | Delete an event |
| `get_event` | Get details of an event |
| `list_task_lists` | List task lists |
| `list_tasks` | List tasks in a list |
| `create_task` | Create a task |
| `update_task` | Update a task |
| `delete_task` | Delete a task |
| `complete_task` | Mark a task as completed |

## Setup

```bash
npm install
npm run build
npm start
```

Copy `.env.example` to `.env` and set your Google service account credentials (JSON file, base64, or individual variables) plus the calendar ID.

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/health` | Health check |
| `POST` | `/mcp` | JSON-RPC endpoint (MCP protocol) |

## Docker

```bash
docker build -t google-calendar-mcp .
docker run -p 8088:8088 --env-file .env google-calendar-mcp
```

## License

ISC