blip

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

useblip.email | Docs | API Reference

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 or via the API:

# 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

brew install bmcreations/tap/blip

blip create
blip inbox --watch

Self-hosted

Prerequisites: JDK 21+, libSQL (sqld)

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:

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 for development setup and contribution guidelines.

# 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 | | mcp-server | MIT | | cli | MIT | | shared-models | MIT |

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.