# SendSoon MCP server

> Enables AI clients to send emails, perform public IP lookups, and convert local documents to Markdown.

- Repository: https://github.com/sendsoon/ai
- Page: https://hostedmcp.org/servers/sendsoon/ai
- Transport: stdio
- Stars: 6
- License: MIT
- Latest version: 0.1.2

## Install

### Claude Code

```sh
claude mcp add --env 'SENDSOON_EMAIL_RECIPIENT=<SENDSOON_EMAIL_RECIPIENT>' --env 'SENDSOON_API_KEY=<YOUR_SENDSOON_API_KEY>' ai -- npx -y @sendsoon/ai
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/ai"
      ],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<SENDSOON_EMAIL_RECIPIENT>",
        "SENDSOON_API_KEY": "<YOUR_SENDSOON_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "ai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/ai"
      ],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<SENDSOON_EMAIL_RECIPIENT>",
        "SENDSOON_API_KEY": "<YOUR_SENDSOON_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"ai","type":"stdio","command":"npx","args":["-y","@sendsoon/ai"],"env":{"SENDSOON_EMAIL_RECIPIENT":"<SENDSOON_EMAIL_RECIPIENT>","SENDSOON_API_KEY":"<YOUR_SENDSOON_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/ai"
      ],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<SENDSOON_EMAIL_RECIPIENT>",
        "SENDSOON_API_KEY": "<YOUR_SENDSOON_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add ai --env 'SENDSOON_EMAIL_RECIPIENT=<SENDSOON_EMAIL_RECIPIENT>' --env 'SENDSOON_API_KEY=<YOUR_SENDSOON_API_KEY>' -- npx -y @sendsoon/ai
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.ai]
command = "npx"
args = ["-y", "@sendsoon/ai"]

[mcp_servers.ai.env]
SENDSOON_EMAIL_RECIPIENT = "<SENDSOON_EMAIL_RECIPIENT>"
SENDSOON_API_KEY = "<YOUR_SENDSOON_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SENDSOON_EMAIL_RECIPIENT=<SENDSOON_EMAIL_RECIPIENT>' -e 'SENDSOON_API_KEY=<YOUR_SENDSOON_API_KEY>' ai npx -- -y @sendsoon/ai
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/ai"
      ],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<SENDSOON_EMAIL_RECIPIENT>",
        "SENDSOON_API_KEY": "<YOUR_SENDSOON_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SENDSOON_EMAIL_RECIPIENT` | yes | no | Recipient address allowed for test sends. |
| `SENDSOON_API_KEY` | no | yes | SendSoon API Key (ssk_live_...). Leave empty for the anonymous trial of three sends per public IP per day. |
| `SENDSOON_API_BASE_URL` | no | no | Override the SendSoon API base URL. Defaults to https://www.sendsoonai.com. |

## FAQ

### Do I need an API key to use SendSoon?

No, an API key is optional for an unregistered trial. You can use an anonymous trial which allows one public IP to send up to three free test emails per day.

### How can I test the tools in a browser before installing them?

You can use the MCP Inspector to see all three tools in a browser and execute them manually.