GoodSender MCP server

Features

• 🛡️ Local server
• Email contents, custom templates, recipient groups and sender identities are stored only on your machine.
• ✉️ Send emails in plain text, HTML or Markdown to one or more recipients.
• ✅ Send consentless transactional emails using built-in templates (OTP, MFA, Order Completion, etc.)
• 🤝 Automatic consent flow handling.
• Recipients added via MCP receive the consent email.
• Emails are queued locally until recipient grants the consent to receive them.
• 📝 Create, edit and store custom templates with dynamic variables.
• Interactive template previews for quick design iteration.
• Send test email to verify template rendering.
• 👥 Organize recipients into groups and reference them all by group name.
• 🏷️ Manage sender identities (From: header) and reference them by name.

Installation

MCP Bundle (.mcpb file, easiest)

• Grab the goodsender.mcpb file from the latest release.
• Double-click the goodsender.mcpb file to open it in your AI client.

Note:

Not every AI client supports MCP bundles or local MCP servers yet.

Use a different installation method if nothing happens on double-click.

Docker image / self-hosting

Run via

docker run -d -e GOODSENDER_API_KEY=<Your API Key> -v goodsender-mcp-data:/data ghcr.io/good-sender/mcp:latest

If your goal is to run the agent using this MCP fully autonomously, set GOODSENDERDISABLEACTION_GUARDS=true to skip all action confirmations completely. See Action confirmation.

or add to docker-compose.yaml on your home server

services:
    goodsender-mcp:
      image: ghcr.io/good-sender/mcp:latest
      ports:
        - "9889:9889"
      environment:
        GOODSENDER_API_KEY: <Your API Key>
        # GOODSENDER_DISABLE_ACTION_GUARDS: "true"  # skip all action confirmations
      volumes:
        - goodsender-mcp-data:/data
      restart: unless-stopped

  volumes:
    goodsender-mcp-data:

and run via

docker compose up -d

Manual configuration (JSON)

• Grab the binaries.zip file from the latest release (includes MCP goodsender-mcp- and CLI goodsender- binaries).
• Unzip it somewhere you can easily reference.
• Modify your AI client config file, adding the MCP server configuration (example for Claude Desktop and Cursor on macOS):

{
      ...
      "mcpServers": {
        "GoodSender": {
          "command": "<path to the unzipped binaries>/goodsender-mcp-darwin-arm64",
          "env": {
            "GOODSENDER_API_KEY": "<Your API key>"
          }
        }
      }
      ...
    }

For other platforms you must reference a corresponding binary instead of darwin (macOS)

If your goal is to run the agent using this MCP fully autonomously, set GOODSENDERDISABLEACTION_GUARDS=true to skip all action confirmations completely. See Action confirmation.

Action confirmation

By default, mutating tools (create, publish, send, and similar) do not run immediately. They return a confirmation token. The agent must call confirm_action after you approve.

Shortened. The full README is on GitHub.