New: the MailCraft MCP server is live — connect your AI agent in one line. Connect your agent →
Start free
AI agents

Claude Desktop

Claude Desktop brings Claude to your Mac or PC. Once MailCraft is connected, it shows up as a tool in any conversation.

Prerequisites

  • Claude Desktop installed
  • Node.js 18 or later (for the mcp-remote bridge)
  • A MailCraft API key with the scopes you want the agent to have — create one under Settings → API keys.

Setup

  1. 1

    Open the config file

    In Claude Desktop open Settings → Developer → Edit Config. The file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows.

  2. 2

    Add MailCraft

    The config file only launches local processes, so connect through the mcp-remote bridge:

    claude_desktop_config.json
    {
  "mcpServers": {
    "mailcraft": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.mailcraft.host",
        "--header", "Authorization:${AUTH}"
      ],
      "env": { "AUTH": "Bearer sk_live_your_api_key" }
    }
  }
}

    Replace sk_live_your_api_key with your key. The agent only gets the tools that key's scopes allow.

  3. 3

    Restart Claude Desktop

    Quit fully and reopen it to load the new configuration.

  4. 4

    Verify the connection

    MailCraft should appear under the tools icon in the message box. Ask:

    claude
    List all my MailCraft domains

On a plan with custom connectors, skip the config file: go to Settings → Connectors → Add custom connector, paste https://mcp.mailcraft.host, and sign in to MailCraft to choose the workspace and scopes.

Example prompts

Once connected, try asking Claude Desktop:

  • Draft a campaign to my "Beta testers" list using the "Launch" template, but don’t send it yet
  • How is my sending reputation this week?
  • Add [email protected] as a contact with plan set to pro

See every tool the agent can use in the MCP server reference.