jcoulaud/shipmail-mcp

Overview

An MCP server that connects AI agents to the Shipmail service for custom-domain business email. It exposes a REST API and webhooks, allowing agents to send, receive, and manage email programmatically. Built in TypeScript, it follows the Model Context Protocol for tool integration.

Best for

Best for
Developers building AI agents that need custom-domain business email capabilities via the Model Context Protocol

Use cases

• Enable AI assistants to send and receive business emails from custom domains
• Trigger email workflows based on incoming webhooks from Shipmail
• Automate email filtering, archiving, or forwarding in agent applications

How to use

Install

bun install --frozen-lockfile --ignore-scripts

Tools exposed

• SHIPMAIL_API_KEY
• SHIPMAIL_API_KEY_FILE
• SHIPMAIL_BASE_URL
• SHIPMAIL_ORGANIZATION_ID
• SHIPMAIL_ALLOW_INSECURE_BASE_URL
• SHIPMAIL_MCP_DEBUG

Clients listed in this record (not verified here)

Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, ChatGPT

Example client config

{
  "mcpServers": {
    "shipmail": {
      "command": "npx",
      "args": [
        "-y",
        "shipmail-mcp"
      ],
      "env": {
        "SHIPMAIL_API_KEY": "sm_live_..."
      }
    }
  }
}

Notes