---
name: gmail
description: "Connect to Gmail via Google API OAuth"
version: "0.1.0"
entry: ./adapter.ts
npm_deps:
  required:
    - googleapis
  optional: []
fields:
  - key: account
    label: "Gmail Account"
    required: true
    sensitive: false
  - key: auth
    label: "Authentication"
    required: true
    sensitive: true
health_check: list_messages
keywords:
  - email
  - gmail
  - google
  - oauth
---

Connect an agent to Gmail for reading and writing email. Requires OAuth
authentication via Google APIs.

## Operations

| Operation | Access | Description |
|-----------|--------|-------------|
| `list_messages` | read | List messages in inbox or label |
| `get_message` | read | Fetch a full message by ID |
| `search_messages` | read | Search using Gmail query syntax |
| `send_message` | write | Send an email |
| `create_draft` | write | Create a draft without sending |

## Configuration

```yaml
connectors:
  - id: email
    adapter: gmail
    access: read-write
    auth: oauth:google:user@gmail.com
    options:
      account: user@gmail.com
```