EmailVerify LogoEmailVerify

CLI Tools

Email checker for CLI tools. Claude Code, Codex, Gemini CLI integration guides.

AI-powered CLI tools can directly call EmailVerify to verify emails during development, debugging, and automation workflows.

Supported CLI Tools

EmailVerify CLI

In addition to AI-powered tools, EmailVerify provides its own CLI for direct verification:

Installation

npm install -g @emailverify/cli

Configuration

bv config set api-key YOUR_API_KEY

Or use environment variable:

export EMAILVERIFY_API_KEY=your-api-key

Basic Commands

# Verify single email
bv verify user@example.com

# JSON output
bv verify user@example.com --json

# Verify multiple emails
bv verify user1@example.com user2@test.com

# Verify from file
bv verify --file emails.txt

# Check credits
bv credits

Output Formats

Human-readable (default):

Email: user@example.com
Status: valid
Score: 0.95
Deliverable: yes
Disposable: no
Role: no

JSON output:

bv verify user@example.com --json
{
  "email": "user@example.com",
  "status": "valid",
  "result": {
    "deliverable": true,
    "disposable": false,
    "role": false
  },
  "score": 0.95
}

Exit Codes

CodeMeaning
0Success, email is valid
1Email is invalid
2Email status unknown
3API error
4Configuration error

Use in scripts:

if bv verify --quiet user@example.com; then
  echo "Email is valid"
else
  echo "Email is invalid or verification failed"
fi

Shell Integration

Add these functions to your .bashrc or .zshrc:

# Quick email verification
vmail() {
  bv verify "$1" --color
}

# Verify and copy result
vmail-copy() {
  bv verify "$1" --json | pbcopy
  echo "Result copied to clipboard"
}

# Check if email is valid (returns 0 or 1)
is-valid-email() {
  bv verify "$1" --quiet &>/dev/null
}

Piping and Automation

# Pipe from stdin
echo "test@example.com" | bv verify --stdin

# Pipe to other commands
bv verify test@example.com --json | jq '.score'

# Extract and verify emails from a file
grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' document.txt | \
  xargs -I {} bv verify {} --quiet

Next Steps

On this page