# email [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/blipemail/blip  
**GitHub Stars:** 1  
**npm Downloads (last month):** 4549  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/email-2

## Description
MCP server for Blip disposable email — create inboxes, receive emails, extract OTP codes

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "email": {
    "url": "https://useblip.email)**"
  }
}
```

## Documentation & README

# blip

Instant disposable email inboxes. API, CLI, MCP server, and web app.

**[useblip.email](https://useblip.email)** | **[Docs](https://useblip.email/docs)** | **[API Reference](https://useblip.email/docs/api)**

[![useblip/email MCP server](https://glama.ai/mcp/servers/blipemail/blip/badges/card.svg)](https://glama.ai/mcp/servers/blipemail/blip)

## Features

- Disposable email addresses with random or custom slugs
- Real-time email delivery via SSE
- OTP and verification link extraction
- Webhooks with HMAC-SHA256 signatures and delivery logs
- CLI for terminal workflows
- MCP server for AI agents
- Multi-domain support

## Architecture

```
blip/
  server/core/      Kotlin/Ktor API server (AGPL-3.0)
  cli/              Kotlin/Clikt CLI
  mcp-server/       TypeScript MCP server (npm: @useblip/email)
  shared-models/    Shared Kotlin data models
```

## Quickstart

### Managed (useblip.email)

No setup required. Create inboxes at [app.useblip.email](https://app.useblip.email) or via the API:

```bash
# Get a session token
curl -X POST https://api.useblip.email/v1/sessions

# Create an inbox
curl -X POST https://api.useblip.email/v1/inboxes \
  -H "Authorization: Bearer <token>"
```

### CLI

```bash
brew install bmcreations/tap/blip

blip create
blip inbox --watch
```

### Self-hosted

Prerequisites: JDK 21+, [libSQL (sqld)](https://github.com/tursodatabase/libsql)

```bash
git clone https://github.com/blipemail/blip.git
cd blip
./gradlew :server:core:buildFatJar

# Start libSQL
sqld --http-listen-addr 127.0.0.1:8081 &

# Run the server
TURSO_URL=http://localhost:8081 WORKER_SECRET=dev-secret \
  java -jar server/core/build/libs/*-all.jar
```

Or with Docker:

```bash
docker build -t blip .
docker run -p 8080:8080 \
  -e TURSO_URL=http://host.docker.internal:8081 \
  -e WORKER_SECRET=your-secret \
  blip
```

## Environment variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `PORT` | No | `8080` | Server port |
| `TURSO_URL` | Yes | `http://localhost:8081` | libSQL/Turso database URL |
| `TURSO_AUTH_TOKEN` | No | — | Turso auth token (production) |
| `WORKER_SECRET` | Yes | `dev-secret` | Shared secret for authenticating inbound email delivery |
| `FRONTEND_URL` | No | `http://localhost:4321` | Frontend URL for CORS |

## Development

See [CONTRIBUTING.md](https://github.com/blipemail/blip/blob/HEAD/CONTRIBUTING.md) for development setup and contribution guidelines.

```bash
# Run tests
./gradlew :server:core:test

# Build CLI
./gradlew :cli:installDist
./cli/build/install/cli/bin/cli --help

# Build MCP server
cd mcp-server && npm install && npm run build
```

## License
This repository uses per-component licensing:

| Component | License |
|---|---|
| `server/core` | [AGPL-3.0](https://github.com/blipemail/blip/blob/HEAD/server/core/LICENSE) |
| `mcp-server` | [MIT](https://github.com/blipemail/blip/blob/HEAD/mcp-server/LICENSE) |
| `cli` | [MIT](https://github.com/blipemail/blip/blob/HEAD/cli/LICENSE) |
| `shared-models` | [MIT](https://github.com/blipemail/blip/blob/HEAD/shared-models/LICENSE) |

The API server is AGPL-3.0 to ensure modifications to the hosted service remain open source.
The MCP server, CLI, and shared models are MIT for maximum adoption flexibility.