# pi-google-services

Google Calendar & Gmail MCP server for Pi. Lets your Pi agent manage your calendar and emails through natural language.

## Setup

```bash
pi-google-services login    # Opens browser → authorize with Google
pi-google-services serve    # Start MCP server (done automatically by Pi)
```

## Calendar tools

### `list-events`
Show events in a date range.

Examples:
- "mostrame los eventos de mañana"
- "qué tengo esta semana?"
- "eventos del 20 al 25 de junio"

Arguments:
- `timeMin` (ISO 8601) — start of range (default: today 00:00)
- `timeMax` (ISO 8601) — end of range (default: today 23:59)
- `calendarId` — calendar to query (default: primary)
- `maxResults` — max events (default: 50)

### `create-event`
Create a new calendar event with optional attendees and Google Meet.

Examples:
- "creá una reunión mañana a las 15"
- "agendá una llamada con juan@gmail.com el jueves a las 10"
- "creá un evento 'Cumpleaños' el 25/12 todo el día"
- "creá un meet virtual mañana a las 16 con Meet"

Arguments:
- `summary` (required) — event title
- `startTime` (required) — ISO 8601 start
- `endTime` (required) — ISO 8601 end
- `attendees` — comma-separated emails to invite
- `withMeet` (boolean) — add Google Meet link
- `description` — event description
- `location` — event location
- `calendarId` — target calendar (default: primary)

### `update-event`
Modify an existing event.

Examples:
- "cambiá la reunión de mañana a las 16"
- "renombrá el evento de la cena a 'Cena con amigos'"

Arguments:
- `eventId` (required) — event to modify
- `summary`, `startTime`, `endTime` — fields to update
- `calendarId` — target calendar (default: primary)

### `delete-event`
Remove an event.

Examples:
- "borrá el evento de prueba del viernes"
- "eliminá la reunión de las 15"

Arguments:
- `eventId` (required) — event to delete
- `calendarId` — target calendar (default: primary)

### `search-events`
Search events by text.

Examples:
- "buscá eventos de 'reunión'"
- "encontrá cuando hablé de 'presentación'"

Arguments:
- `query` (required) — text to search
- `maxResults` — max results (default: 50)

### `list-calendars`
List all available calendars.

Examples:
- "mostrame mis calendarios"
- "qué calendarios tengo?"

### `get-freebusy`
Check availability across calendars.

Examples:
- "estoy libre mañana a las 15?"
- "qué horarios tengo ocupados esta semana?"

Arguments:
- `timeMin`, `timeMax` — range to check
- `calendarIds` — comma-separated calendar IDs

## Gmail tools

### `list-inbox`
List recent inbox messages.

Examples:
- "mostrame mis emails"
- "qué hay en mi bandeja de entrada?"
- "mostrame los últimos 5 emails de LinkedIn"

Arguments:
- `maxResults` — max emails (default: 20)
- `query` — optional Gmail search filter

### `get-email`
Read a full email by ID.

Examples:
- "leé el primer email de la lista"
- "mostrame el contenido completo del mail de belo"

Arguments:
- `id` (required) — email message ID

### `search-emails`
Search emails with Gmail syntax.

Examples:
- "buscá emails de belo"
- "encontrá mails sobre 'Uber' de esta semana"
- "mostrame los no leídos"

Arguments:
- `query` (required) — Gmail search query
- `maxResults` — max results (default: 20)

### `send-email`
Send a new email with optional file attachments.

Examples:
- "enviále un mail a lucsk94@gmail.com con asunto 'Prueba' y cuerpo 'Hola, esto es una prueba'"
- "mandále un email a juan@mail.com diciendo que la reunión se pasó al viernes"
- "enviále un email a maria@work.com con el PDF /home/user/reporte.pdf adjunto"

Arguments:
- `to` (required) — recipient email
- `subject` (required) — email subject
- `body` — email body text
- `attachments` — array of files to attach. Each item can have `localPath` (local file) or `driveFileId` (Google Drive file ID)

### `reply-to-email`
Reply to an existing thread with optional file attachments.

Examples:
- "respondé el mail de Natalia aceptando la invitación"
- "contestále al de belo que ya lo vi"
- "respondé al mail de ventas adjuntando /home/user/cotizacion.pdf"

Arguments:
- `threadId` (required) — thread to reply to
- `to` (required) — recipient email
- `subject` (required) — reply subject
- `body` — reply body text
- `attachments` — array of files to attach. Each item can have `localPath` (local file) or `driveFileId` (Google Drive file ID)

## Tasks tools

### `list-tasklists`
Show all task lists.

Examples:
- "mostrame mis listas de tareas"

### `list-tasks`
List tasks (pending, completed, or all).

Examples:
- "mostrame mis tareas pendientes"
- "qué tareas tengo para hacer?"
- "mostrame las tareas completadas"

Arguments:
- `taskListId` — task list ID (default: @default)
- `status` — filter: pending, completed, or '' for all
- `maxResults` — max results (default: 50)

### `create-task`
Create a new task.

Examples:
- "creá una tarea para comprar leche"
- "agendá 'llamar al dentista' para mañana"

Arguments:
- `title` (required) — task title
- `taskListId` — target list (default: @default)
- `notes` — optional description
- `dueDate` — due date (YYYY-MM-DD)

### `complete-task`
Mark a task as done.

Examples:
- "marcá como hecha la tarea de la leche"
- "completá la tarea del dentista"

Arguments:
- `taskId` (required) — task to complete
- `taskListId` — target list (default: @default)

### `delete-task`
Delete a task.

Examples:
- "borrá la tarea de prueba"

Arguments:
- `taskId` (required) — task to delete
- `taskListId` — target list (default: @default)