Mailmodo

You operate a Mailmodo MCP server that exposes a simple interface for Claude Desktop and other MCP clients to manage Mailmodo templates, campaigns, contacts, and events. This server lets clients start, connect, and run Mailmodo actions through the MCP protocol, enabling automated workflows and integrated tooling.

How to use

You connect an MCP client to the Mailmodo MCP server using one of the available runtime configurations. You can run the server locally from your codebase, run it via Docker, start it with npx, or connect to a remote MCP service. Once connected, you can perform common actions such as listing templates, campaigns, and contact lists, and you can trigger campaigns or send events using the provided tools.

To use a local setup, provide the runtime command that starts the server from your development environment. For example, you can start the server by running node with the built index file after you have compiled the TypeScript code.

How to install

Prerequisites: you need Node.js version 20 or higher and npm (which comes with Node.js).

Install via the automated installer if you have access to Smithery:

npx -y @smithery/cli install @mailmodo/mailmodo-mcp --client claude

Manual installation steps:

git clone https://github.com/mailmodo/mailmodo-mcp.git
cd mailmodo-mcp
npm install

Build the project to compile TypeScript into JavaScript, producing a dist directory with the compiled files.

npm run build

Run the project after building. You can start it directly or use the npm script.

node dist/index.js

npm start

Claude Desktop configuration and ways to run

Configure Claude Desktop to connect to the Mailmodo MCP server in one of the supported ways. Use the following configurations as examples.

{
  "mcpServers": {
    "mailmodo": {
      "command": "node",
      "args": [
        "/path/to/your/mailmodo-mcp/dist/index.js"
      ]
    }
  }
}

Run from a Docker image. This starts the server in a container and passes the API key as an environment variable.

{
  "mcpServers": {
    "mailmodo": {
      "command": "docker",
      "args": [
        "run",
        "--platform", 
        "linux/amd64",
        "-i",
        "--rm",
        "-e",
        "MAILMODO_API_KEY",
        "avneesh001/mailmodo-mcp"
      ],
      "env": {
        "MAILMODO_API_KEY": "<GET MAILMODO KEY from https://manage.mailmodo.com/app/settings/apikey and insert here>"
      }
    }
  }
}

Run from npx. This is useful for quick trials without installing dependencies locally.

{
  "mcpServers": {
    "mailmodo": {
      "command": "npx",
      "args": [
        "-y",
        "@mailmodo/mcp"
      ],
      "env": {
        "MAILMODO_API_KEY": "<GET MAILMODO KEY from https://manage.mailmodo.com/app/settings/apikey and insert here>"
      }
    }
  }
}

Connect via a remote server. Use this to point directly to a remote MCP endpoint with an API key header.

{
  "mcpServers": {
    "mailmodo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.app.mailmodo.com/mcp",
        "--header",
        "mmApiKey:${MAILMODO_API_KEY}"
      ],
      "env": {
        "MAILMODO_API_KEY": "<GET MAILMODO KEY from https://manage.mailmodo.com/app/settings/apikey and insert here>"
      }
    }
  }
}

Make sure to adjust the file path in the args array to match your local project directory.

Tools and capabilities

The Mailmodo MCP server exposes a set of tools to interact with Mailmodo resources and actions. You can query templates, campaigns, and contact lists, manage contacts, and trigger campaigns or events.

Available tools

userDetails

Get all details of a contact by email

MailmodoCampainReportTool

Get campaign reports including open, click, and submission counts – requires campaignId and date range

currentDateTime

Get current date and time

sendEvent

Send custom events with email and event properties (optional timestamp and event properties)

addContactToList

Add a single contact to a specified list with optional metadata

addBulkContactToList

Add multiple contacts to a list in one operation, providing a listName and an array of values

removeContactFromList

Remove a contact from a specific list by email and listName

unsubscribeContact

Unsubscribe or suppress a contact by email

resubscribeContact

Resubscribe a previously unsubscribed contact by email

archiveContact

Permanently archive a contact by email

sendEmailToCampaign

Trigger an email campaign with personalization for a recipient

broadcastCampaignToList

Trigger a campaign to an entire contact list with optional customization