# gmail-mcp-server

Standalone Gmail MCP Server — draft-only. Lane never sends; the single tool creates a Gmail draft the owner reviews and sends themselves.

## Tools

### `gmail_draft_compose`

Creates a Gmail draft.

| Arg | Type | Required | Notes |
| --- | --- | --- | --- |
| `accessToken` | string | no | Falls back to `GMAIL_ACCESS_TOKEN` env var |
| `to` | string | no | Leave empty if unknown — the owner fills it in when reviewing the draft |
| `subject` | string | yes | |
| `body` | string | yes | Plain text |

Returns `{ draftId, messageId, draftUrl }`.

There is no send tool, no read tool, and no label/thread management in this server — it composes drafts only.

## Install / Dev

```bash
npm install
npm run dev      # run the server via tsx
npm run build    # compile to dist/
npm run check    # test + build
```

## Auth

Requires an OAuth 2.0 access token with the **`gmail.compose`** scope only — never `gmail.send`. Set it via `GMAIL_ACCESS_TOKEN` or pass `accessToken` per call. See `.env.example`.