Lumail
io.github.MelvynxPublished by GitHub account Melvynxv0.4.0Updated Oct 24, 2026
Official Lumail email marketing MCP for campaigns, subscribers, and workflows.
Overview
Lumail's official email marketing MCP: lets an assistant read subscribers, tags and campaigns, and draft campaigns and workflows in your Lumail organization.
- What you can do
- Read subscribers, tags, senders, custom fields, snippets and writing style
- Review campaigns, campaign analytics and progress, workflows and workflow groups
- Check organization stats and subscriber growth
- Add subscribers and create or apply tags
- Create, edit and duplicate campaign drafts, and create or configure workflow drafts
- When to use it
- Useful when you run email marketing in Lumail and want an assistant to answer questions about campaign performance and list growth, draft campaigns or welcome sequences, or add and tag subscribers without leaving the chat.
- Requirements
- Remote MCP endpoint at lumail.io/mcp over streamable HTTP, protected by OAuth 2.1 with browser sign-in, PKCE and dynamic client registration. You must be an owner or admin of the Lumail organization you authorize, and you choose that organization and the scopes during the browser flow. No API token or environment variables are needed for the MCP connection.
Installation
In SourceWeft
- Open Lumail in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.Melvynx%2Flumail/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"lumail": {
"type": "http",
"url": "https://lumail.io/mcp"
}
}
}README
Lumail Agent Skills and Plugins
Install Lumail's agent skills or connect Lumail to Claude Code and Codex. The repository includes reusable marketing and copywriting skills alongside the Lumail CLI and OAuth MCP plugin skills.
Agent plugins authenticate with browser OAuth. Those sessions have no API
token to create, paste, or store. The WordPress plugin in wordpress/ is
the exception: it uses a lum_ organization token on the server.
Install
The fastest path is to let your agent do it. Paste this into Claude Code:
or into Codex:
or, for the terminal workflow (full API, including sending), into any agent:
Prefer to run it yourself:
Full guides: docs/claude-code-install.md · docs/codex-install.md
What is in here
claude/skills and codex/skills are real copies of skills/ (symlinks break
on Windows checkouts), so both hosts ship the same skills. Edit the
top-level skills/ first, then sync the copies.
How the connection works
The plugin points both hosts at https://lumail.io/mcp, an OAuth 2.1 protected
resource. The host registers itself through dynamic client registration, runs
PKCE, and stores the access token itself. During the browser flow you sign in,
pick which organization the agent may reach, and approve the scopes. Only
owners and admins of an organization can authorize it.
Access tokens carry the organization as a claim, so a session can never reach another organization in your account. Revoke from the connected-apps list in Lumail settings and access stops on the next request, with no local config to clean up.
What agents can do
Read — subscribers, tags, campaigns, campaign analytics and progress, workflows and workflow groups, org stats, subscriber growth, senders, custom fields, snippets, writing style.
Write — add subscribers, create and apply tags, create and edit campaign drafts, duplicate campaigns, create and configure workflow drafts.
Not available over OAuth — sending, scheduling, publishing or activating a
workflow, unsubscribing, and every delete. Those tools are not registered on
this endpoint, so an agent cannot reach them even with your approval. Do that
work in the Lumail app, or with npx lumail if you want it in a terminal.
The CLI
npx lumail reaches the full API, including sending. It authenticates with the
same browser flow:
The lumail skill in this repository teaches agents the whole CLI.
WordPress plugin
wordpress/ is a PHP plugin: settings page for a lum_ token, shortcode
[lumail_form], server-side POST /api/v2/subscribers. Copy the folder to
wp-content/plugins/lumail. Details: wordpress/README.md
and wordpress/BUILD.md.
Example prompts
How did last week's newsletter perform compared to the one before?Draft a launch campaign with three subject line options.Add [email protected] to my newsletter and tag them vip.Build a three-email welcome sequence over a week and leave it as a draft.Show me subscriber growth over the last 30 days.
Support
MIT licensed.
Source: README.md at commit c578f3d
Tools
0Version history
1- v0.4.0LatestSep 16, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.