Labsco
MCP SERVER

Gemini Email Subject Generator MCP

by falahgs

Sends email with the subject line written by Gemini from your prompt — HTML, plain text, and inline image attachments.

Email: Mailboxes & Delivery
Summary
It sends real mail from the account you configure.

This holds a working SMTP login and can send from it, so the account you configure is the account an assistant can send as. Using a Gmail app password rather than your main password, as the README instructs, is the minimum. The generation itself is narrowly scoped in a way that helps: the model writes the subject line, and the body stays exactly what you wrote.

What it is

An MCP server that sends email over SMTP with the subject line generated by Google's Gemini model from a prompt you supply. It also carries a general-purpose reasoning tool that writes its output to disk. Built for Claude Desktop and other MCP clients.

What you get
  • `send-email` — takes a recipient, a `subjectPrompt` describing the subject you want, plain text and optional HTML bodies, and an optional array of images; the subject is generated from the prompt and the mail is sent, with status reported back
  • Image attachments that can display inline in the HTML body, passed as base64 data URIs
  • `generate-thinking` — a detailed reasoning pass over a prompt, saved to a timestamped file in an output directory you can set per call
  • A specific caveat the author calls out: the confirmation you see after sending is feedback that the operation succeeded, not the content of the email — the recipient gets only the text and HTML you supplied, with the Gemini-generated subject
Requirements

A Google Gemini API key in `GEMINI_API_KEY`, and an SMTP email account: `NODEMAILER_EMAIL` and `NODEMAILER_PASSWORD`, which for Gmail must be an app password rather than your account password. Node.js v16 or higher and TypeScript; clone, `npm install`, write the `.env`, `npm run build`, then point your client at the built entry point with the working directory set. Adding `DEBUG=true` turns on verbose logging. MIT licensed.

Setup effort

Build from source — clone the repository and build it, then point your client at the binary