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

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.