Skip to content

The whole email operation, in your terminal.

Paste one line into any agent with a terminal. It installs the CLI, signs in, and adds the lumail skill. Sending included.

Paste this into any agent
Read lumail.io/cli/install and set up the Lumail CLI for me.
See the manual setup
zsh
npm install -g lumail
lumail auth login
Opening browser · signed in · org: Acme
lumail subscribers create --email [email protected] --tags vip
[email protected] · SUBSCRIBED · tags: vip

Setup

  1. 1. Install the CLI

    npm install -g lumail

  2. 2. Sign in through your browser

    lumail auth login

  3. 3. Install the lumail skill

    pnpm dlx skills add Melvynx/lumail-skills -g

  4. 4. Verify

    lumail auth test
lumail campaigns list --json
Set up the Claude Code pluginSet up the Codex plugin

Questions

What is the Lumail CLI?

A command-line client for the full Lumail API, published on npm as lumail. It covers subscribers, tags, campaigns, transactional email, events and the V2 tools, and prints results as text, JSON or CSV.

What does the lumail skill add?

The skill is a Markdown file that teaches an agent every CLI command, its flags, its output formats and the safety rules. Without it an agent has to guess; with it, 'add [email protected] with the vip tag' becomes the right command on the first try.

Do I need an API token?

No. lumail auth login runs a browser OAuth flow and writes a self-refreshing credential to ~/.config/lumail/oauth.json. API tokens via lumail auth set still exist for CI and named service accounts.

Can the CLI send a campaign?

Yes. lumail campaigns send and lumail emails send both work — this is the difference from the OAuth plugin, which does not register those tools at all. The skill requires an agent to confirm with you before running anything irreversible.

Which agents does it work with?

Any agent that can run a shell command. The skill installs into ~/.claude/skills for Claude Code and ~/.agents/skills for Codex and other agents that read a shared skills directory.

Do I need a paid plan?

No. The free plan includes API and CLI access, with 3,000 emails a month. Rate limits are counted per organization and rise with your plan.

How do I remove it?

lumail auth remove clears the credential, npm uninstall -g lumail removes the CLI, and deleting ~/.claude/skills/lumail or ~/.agents/skills/lumail removes the skill. Revoking the app from Lumail settings cuts access immediately.