> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Client Integration Guides

> One-click install buttons and step-by-step setup guides for Cursor, Google Antigravity, Claude Desktop, Windsurf, VS Code, and Zed.

# Client Integration Guides

Connect the Mailofly MCP server to your AI editor with a single click or a quick configuration snippet. The server runs via standard Stdio transport with zero local build requirements.

***

## One-Click & Quick Add

<div className="mcp-install-grid">
  <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=mailofly&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtYWlsb2ZseS9tY3AiXSwiZW52Ijp7Ik1BSUxPRkxZX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkifX0=" className="mcp-install-btn mcp-install-btn-cursor">
    <svg viewBox="0 0 24 24" fill="currentColor">
      <path d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5M2 12l10 5 10-5" />
    </svg>

    <span>Add to Cursor</span>
  </a>

  <a href="#google-antigravity" className="mcp-install-btn mcp-install-btn-antigravity">
    <svg viewBox="0 0 24 24" fill="currentColor">
      <path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
    </svg>

    <span>Add to Antigravity</span>
  </a>

  <a href="#claude-desktop" className="mcp-install-btn">
    <svg viewBox="0 0 24 24" fill="currentColor">
      <circle cx="12" cy="12" r="10" />
    </svg>

    <span>Add to Claude</span>
  </a>
</div>

***

## Select Your AI Client

Choose your environment below to view tailored installation options and configuration snippets:

<Tabs>
  <Tab title="Cursor" icon="code">
    ### Method A: One-Click Deep Link

    Click the button below to trigger Cursor's automated MCP installation dialog:

    <div style={{ margin: "1rem 0" }}>
      <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=mailofly&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtYWlsb2ZseS9tY3AiXSwiZW52Ijp7Ik1BSUxPRkxZX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkifX0=">
        <img src="https://img.shields.io/badge/Install%20in%20Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white" alt="Install in Cursor" />
      </a>
    </div>

    ***

    ### Method B: Project Configuration (Recommended)

    Create or edit `.cursor/mcp.json` in your repository root:

    ```json theme={null}
    {
      "mcpServers": {
        "mailofly": {
          "command": "npx",
          "args": ["-y", "@mailofly/mcp"],
          "env": {
            "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
          }
        }
      }
    }
    ```

    ***

    ### Method C: Global GUI Setup

    1. Open **Cursor Settings** (`Cmd + ,` on macOS or `Ctrl + ,` on Windows).
    2. Navigate to **Features** > **MCP**.
    3. Click **+ Add New MCP Server**.
    4. Fill in:
       * **Name**: `mailofly`
       * **Type**: `command`
       * **Command**: `npx -y @mailofly/mcp`
    5. Add environment variable `MAILOFLY_API_KEY`.
    6. Click **Save**.
  </Tab>

  <Tab title="Google Antigravity" icon="sparkles">
    ### Method A: Configuration File (Recommended)

    Add the `mailofly` server to your global user configuration (`~/.gemini/config/mcp_config.json` on macOS/Linux, or `%USERPROFILE%\.gemini\config\mcp_config.json` on Windows):

    ```json theme={null}
    {
      "mcpServers": {
        "mailofly": {
          "command": "npx",
          "args": ["-y", "@mailofly/mcp"],
          "env": {
            "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
          }
        }
      }
    }
    ```

    You can also define it at the project level in `.gemini/antigravity-ide/mcp_config.json`.

    ***

    ### Method B: Antigravity CLI

    If you have the Antigravity CLI (`agy`) installed in your PATH:

    ```bash theme={null}
    agy mcp add mailofly -- npx -y @mailofly/mcp
    ```

    <Tip>
      Antigravity autonomous agents automatically detect Mailofly tools during execution loops, allowing agents to check sending quotas, review delivery logs, or trigger test emails autonomously.
    </Tip>
  </Tab>

  <Tab title="Claude Desktop" icon="robot">
    ### Method A: Claude Code (CLI)

    If you use Claude Code in your terminal, add Mailofly with a single command:

    ```bash theme={null}
    claude mcp add mailofly -- npx -y @mailofly/mcp
    ```

    ***

    ### Method B: Claude Desktop Configuration

    Locate your `claude_desktop_config.json`:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
    * **Linux**: `~/.config/Claude/claude_desktop_config.json`

    Add `mailofly` to the `mcpServers` object:

    ```json theme={null}
    {
      "mcpServers": {
        "mailofly": {
          "command": "npx",
          "args": ["-y", "@mailofly/mcp"],
          "env": {
            "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
          }
        }
      }
    }
    ```

    <Tip>
      Restart Claude Desktop after saving. You will see a hammer icon 🔨 in the chat box showing that Mailofly tools are active.
    </Tip>
  </Tab>

  <Tab title="Windsurf" icon="wind">
    ### Cascade MCP Configuration

    1. Open Windsurf Settings (`Cmd + ,` or `Ctrl + ,`).
    2. Navigate to **Advanced Settings** > **Cascade** > **Model Context Protocol (MCP)**, or edit `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "mailofly": {
          "command": "npx",
          "args": ["-y", "@mailofly/mcp"],
          "env": {
            "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code (Cline / Roo)" icon="laptop-code">
    ### Extension Configuration

    In VS Code with **Cline** or **Roo Code** installed:

    Open `cline_mcp_settings.json` (accessible by clicking the MCP icon in the extension sidebar) and add:

    ```json theme={null}
    {
      "mcpServers": {
        "mailofly": {
          "command": "npx",
          "args": ["-y", "@mailofly/mcp"],
          "env": {
            "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Zed" icon="terminal">
    ### Zed Assistant Configuration

    Open your Zed settings (`~/.config/zed/settings.json`) and configure the experimental MCP transport:

    ```json theme={null}
    {
      "experimental": {
        "model_context_protocol": {
          "servers": {
            "mailofly": {
              "command": "npx",
              "args": ["-y", "@mailofly/mcp"],
              "env": {
                "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
              }
            }
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

## Verifying Your Connection

Once configured in any client, start a new chat with your AI assistant and enter:

```markdown theme={null}
"Check my Mailofly email sending quota and list verified domains."
```

Your assistant will immediately invoke `mailofly_get_usage` and `mailofly_list_domains`, returning live status data from your account!


## Related topics

- [MCP Server Guides](/guides/ai/mcp-ai-guides.md)
- [MCP Server](/mcp-server/introduction.md)
- [Integrations](/integrations/index.md)
- [SDKs & Integrations](/sdks/index.md)
- [n8n Integration](/guides/tutorials/n8n-integration.md)