GoodSender

GoodSender MCP Server

Publish blog posts, send newsletters and emails from Claude, Claude Code, Codex and ChatGPT. Send consent-based email and transactional email (OTP and MFA codes), and publish blog posts on your own domain. Connect to the hosted server with OAuth and nothing to install, or run it locally with an API key.

What you can do

Ask your assistant things like:

• "Write a post about our new release, publish it on my blog and email it to subscribers."
• "Draft a post from these notes and show me the preview before anything goes live."
• "Connect blog.example.com to my blog and tell me which DNS records to add."
• "Create a custom design for my blog that matches our logo, and show me a preview first."
• "Send a password reset code to user@example.com with the OTP template."
• "Email the March update to the beta-users group."

Posts are always created as drafts. Before publishing, the assistant shows where the post will go (your blog, the newsletter, connected social accounts) and asks you to approve it. See Action confirmation for how approval works on the hosted and local servers. The newsletter email carries the subject, the cover image when one is set, a summary and a link to the published post, not the full post body. Transactional templates such as OTP codes send right away. Other emails wait until the recipient consents. See Email sending.

Quick start (hosted, OAuth)

Hosted server URL:

https://mcp.goodsender.com/

You sign in to GoodSender in the browser the first time the client connects. To use blog tools, you need a GoodSender workspace with a blog. To send the optional newsletter, set up its sender identity and a public blog address first.

Claude Desktop

On Free, Pro or Max: open Customize → Connectors, choose Add → Add custom connector, and enter https://mcp.goodsender.com/. Keep the sign-in option so the OAuth flow runs the first time you use the connector.

On Team or Enterprise, an organization owner first adds GoodSender in Organization settings → Connectors → Add → Custom → Web. Members can connect it after that.

Claude Code

claude mcp add --transport http goodsender https://mcp.goodsender.com/

claude mcp login goodsender

Complete the OAuth flow in the browser. Check the connection with claude mcp get goodsender, or run /mcp in an interactive session.

Codex

codex mcp add goodsender --url https://mcp.goodsender.com/

codex mcp login goodsender

The Codex CLI and IDE extension share this configuration. The login command completes the browser flow.

ChatGPT

Turn on developer mode under Settings → Apps & Connectors → Advanced settings. Create an app with the server URL https://mcp.goodsender.com/ and OAuth authentication, then sign in to GoodSender when prompted. Pick the app from the + menu in a new chat.

Publishing needs MCP apps with write actions. OpenAI offers these as a beta on Business, Enterprise and Edu workspaces, and an admin may have to allow developer mode. Other plans may connect read-only. Menu names change between ChatGPT releases.

Gemini CLI

gemini extensions install https://github.com/good-sender/mcp

The extension adds the hosted server. The browser sign-in (OAuth) opens the first time a tool runs; run /mcp auth goodsender in a session to sign in again. Gemini CLI is available to organisations on Gemini Code Assist Standard or Enterprise and through paid Gemini API keys. Individual Google AI accounts moved to Antigravity CLI on 2026-06-18; that CLI is not covered here.

Full guide: goodsender.com/docs/mcp.

Local install

The local server uses an API key. Create one on the API keys page of your GoodSender dashboard. Treat the key as a secret: never commit or share it.

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 GOODSENDER_DISABLE_ACTION_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:

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): json { ... "mcpServers": { "GoodSender": { "command": " /goodsender-mcp-darwin-arm64", "env": { "GOODSENDER_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 GOODSENDER_DISABLE_ACTION_GUARDS=true to skip all action confirmations completely. See Action confirmation.

Environment variables

Action confirmation

Every tool declares whether it only reads, or changes something. Tools that publish, send, delete or change live state are marked destructive, so clients such as Claude ask you before running them.

• Hosted server (mcp.goodsender.com): that client prompt is the approval step. Tools run when you approve the call, and confirm_action is not offered.
• Local server: action guards add a second step by default. A tool that publishes, sends, deletes or changes the live blog design returns a confirmation token instead of acting, and confirm_action runs it once you approve. Set GOODSENDER_DISABLE_ACTION_GUARDS=true in the server environment to skip that step, for example for unattended loops (scheduled agents, CI).
• CLI (the goodsender-* binaries in binaries.zip): runs with action guards off. A command you type is the approval, so it acts immediately and there is no confirm_action step.

Email sending

GoodSender sends email as well as blog posts. Permission protects deliverability, so cold outreach is not supported. Email tools work with the hosted server and with a local server.

• 🤝 Consent handling. Recipients you add get a consent request by email. Custom emails to a recipient without consent wait in a queue. Emails to recipients who already consented go out right away.
• 🔁 Consent flow. You do not track consent yourself. After a recipient consents, their queued emails go out when you ask to send pending emails (send_pending_emails) or use another tool that sends email. Nothing is sent while the server is idle.
• ✅ Transactional templates. Built-in templates send right away, without a consent step: OTP code, MFA enrollment, new device login, password changed, email changed, order receipt and order completed.
• ✉️ Formats. Send plain text, HTML or Markdown to one or more addresses, or to whole groups.
• 📝 Custom templates. Create and edit templates with dynamic variables. Preview them in the chat with sample data, send a test email, then save and send by template name.
• 👥 Recipient groups. Organize recipients into groups and address a whole group by name.
• 🏷️ Sender identities. Manage From: identities on a verified domain and refer to them by name.
• 📊 Health metrics. Check email health metrics for each sender domain.
• 🛡️ Where data lives. Pending emails, custom templates, recipient groups and sender identities are stored in the MCP server's database: on your machine for a local server, on the server host for the hosted connection. Sending uses the GoodSender API. Blog posts, settings and designs are stored on GoodSender servers.

Example email prompts

Add 'John Doe <john.doe@example.com>' and 'Jane Doe <jane.doe@example.com>' to the AI newsletter subscribers group

ℹ️ This will:

- Create/update the recipients in the database

- Add them to the "AI newsletter subscribers" recipient group, creating it if needed

Create a GoodSender template for a weekly AI news digest sent to the AI newsletter subscribers group

ℹ️ This will:

- Create a draft email template in GoodSender format following best practices for email template creation

- Display interactive preview of this template draft (if AI client supports it)

Increase the number of news in the digest to 5

ℹ️ Done during the template draft creation/editing, this will:

- Modify the template accordingly

- Display interactive preview of this template draft (if AI client supports it)

Send a test email to me: 'Good Sender <good.sender@example.com>'

ℹ️ Done during the template draft creation/editing, this will:

- Send an email with mocked data generated from the current template draft only to you

Save the template as "Weekly AI news"

ℹ️ Done during the template draft creation/editing, this will:

- Convert the current template draft to a persistent template stored in the MCP server's database

- Allow sending emails just by mentioning the template name

Gather this week's AI news and send them using the "Weekly AI news" template

ℹ️ This will:

- Create and enqueue a personalized template-based email for each recipient in the AI newsletter subscribers group

- For all recipients who haven't received an email with consent request, will request their consent for receiving emails from you

- Send emails to all recipients who granted their email consent

- Keep the other emails queued; they go out after the recipient consents, when you send pending emails

Tools

Blog and newsletter

| `