@luminarylane/gmail-mcp-server
v1.0.2
Published
Standalone Gmail MCP Server — draft-only tool for the Gmail API
Readme
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 + buildAuth
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.
