Email Composer

Drafts a single email, shows the exact message for approval, then sends it or saves it as a Gmail draft. It never sends without a clear yes to that exact message.

Used by our sales team

What It Does

It writes one email to one person, shows the full message, and waits. You can ask for edits, save the message as a Gmail draft, or approve it for sending. Nothing is sent until you say yes to that exact message. Bulk sending, cc and bcc are not supported.

Who Uses It

Sales and account people who write individual emails to prospects and clients and want a second pair of hands on the wording, with a hard stop before anything leaves their account.

Setup

Install the skill by copying the skill/ folder into your agent's skills folder as email-composer, for example .claude/skills/email-composer/. You can also fetch it through the Thinqmesh MCP server.

Writing and previewing work with no further setup. Sending and drafting need your own Google sign-in.

1. Install Python 3.9 or newer, then from the skill folder run python -m pip install -r scripts/requirements.txt.
2. In a Google Cloud project you own, enable the Gmail API. Set up the OAuth consent screen and add your own address as a test user.
3. Create an OAuth client of type Desktop app and download its JSON file.
4. Save the file as client_secret.json in the .config/email-composer folder inside your home folder. To use another folder, set the environment variable EMAIL_COMPOSER_DIR to it.
5. Run python scripts/auth_setup.py, sign in and approve two permissions: send email and create drafts.

Your sign-in is saved as gmail_login.json in that same folder, on your machine only. The skill ships with no client file and no login. Never share either file. To sign out, delete the login file and revoke access in your Google account settings.

The sending path has not been tested against a live Gmail account. Run a first check by saving a draft to yourself before relying on it.

Example Result

To: sam@example.com
Subject: Following up on Thursday

Hi Sam,

Thanks for the time on Thursday. I have attached the outline we discussed.
Could you let me know by Friday whether the second option works for you?

Best,
Alex

Attachments: outline.pdf

The agent then asks: send this, save it as a draft, or change something.

How to Adapt

Keep a folder of Markdown templates with a subject line and placeholders such as {{ first_name }}, and point the agent at it. Change the tone rules in step 3 of SKILL.md to match how your team writes. The scripts accept one recipient by design; keep it that way.