# Blip MCP server

> Create disposable email inboxes, receive messages, and extract OTP codes directly through an AI agent.

- Repository: https://github.com/blipemail/blip
- Page: https://hostedmcp.org/servers/blipemail/email
- Transport: stdio
- Stars: 1
- Latest version: 0.1.3

## Install

### Claude Code

```sh
claude mcp add --env 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' email -- npx -y @useblip/email
```

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

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@useblip/email"
      ],
      "env": {
        "BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "email": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@useblip/email"
      ],
      "env": {
        "BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"email","type":"stdio","command":"npx","args":["-y","@useblip/email"],"env":{"BLIP_API_KEY":"<YOUR_BLIP_API_KEY>"}}'
```

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

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@useblip/email"
      ],
      "env": {
        "BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add email --env 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' -- npx -y @useblip/email
```

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

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

[mcp_servers.email.env]
BLIP_API_KEY = "<YOUR_BLIP_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' email npx -- -y @useblip/email
```

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

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@useblip/email"
      ],
      "env": {
        "BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BLIP_API_KEY` | yes | yes | Your Blip API key |

## Tools (7)

- `create_inbox`
- `list_inboxes`
- `get_inbox`
- `read_email`
- `extract_codes`
- `wait_for_email`
- `delete_inbox`

## FAQ

### What tools are available in this server?

The server provides tools to create inboxes, list inboxes, get inbox details, read email content, extract OTP codes, wait for incoming emails, and delete inboxes.

### Can I use a self-hosted version of the API?

Yes, you can specify a custom API base URL using the BLIP_API_URL environment variable.
