# Voidmail MCP server

> Allows AI agents to create inboxes, read incoming messages as structured data, and send emails to owner-approved recipients.

- Repository: https://github.com/voidly-ai/mcp-email
- Page: https://hostedmcp.org/servers/voidly-ai/voidmail
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 0.1.0

## Install

### Claude Code

```sh
claude mcp add --transport http voidmail https://api.voidly.ai/mcp/mail
```

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

```json
{
  "mcpServers": {
    "voidmail": {
      "url": "https://api.voidly.ai/mcp/mail"
    }
  }
}
```

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

```json
{
  "servers": {
    "voidmail": {
      "type": "http",
      "url": "https://api.voidly.ai/mcp/mail"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"voidmail","type":"http","url":"https://api.voidly.ai/mcp/mail"}'
```

### Codex

```sh
codex mcp add voidmail --url https://api.voidly.ai/mcp/mail
```

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

```toml
[mcp_servers.voidmail]
url = "https://api.voidly.ai/mcp/mail"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http voidmail https://api.voidly.ai/mcp/mail
```

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

```json
{
  "mcpServers": {
    "voidmail": {
      "url": "https://api.voidly.ai/mcp/mail",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `VOIDMAIL_ADDRESS` | no | no |  |
| `VOIDMAIL_CREATOR_SIGNING_KEY_FILE` | no | no |  |

## Tools (21)

- `voidmail_create_account`
- `voidmail_account_info`
- `voidmail_list_inbox`
- `voidmail_read_email`
- `voidmail_search_inbox`
- `voidmail_wait_for_email`
- `voidmail_extract_code`
- `voidmail_sending_limits`
- `voidmail_send_once`
- `voidmail_send_status`
- `voidmail_send_email`
- `voidmail_policy`
- `voidmail_request_recipient`
- `voidmail_revoke_recipient`
- `voidmail_mark_read`
- `voidmail_delete_email`
- `voidmail_create_alias`
- `voidmail_list_aliases`
- `voidmail_delete_alias`
- `voidmail_set_webhook`
- `voidmail_get_stats`

## FAQ

### How do I create a new inbox?

You can create an inbox using the command line with npx or by calling the voidmail_create_account tool directly from an MCP agent.

### Is the email communication end-to-end encrypted?

No. While stored mail can be encrypted to an owner key, incoming mail is plaintext to the receiving server momentarily, and outgoing mail to external addresses is not end-to-end encrypted.

### What happens if I lose my encryption keys?

If you lose your keys and backups, the stored mail cannot be recovered by anyone, including Voidly.