Create disposable email inboxes, receive messages, and extract OTP codes directly through an AI agent.
Also known as blipemail/blip, @useblip/email
- Stars
- 1
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Oct 2, 2026
- License
- —
What is Blip MCP?
Blip creates disposable email inboxes, receive messages, and extract OTP codes directly through an AI agent. It exposes 7 tools, such as create_inbox, list_inboxes, get_inbox.
Summary generated from the project's README
About Blip MCP server
Managing disposable email addresses and retrieving verification codes through an AI agent is what this server enables. Developers can use it to automate sign-up processes or test email workflows by creating temporary inboxes and reading incoming messages without leaving their chat interface. It works with Claude Desktop, Claude Code, and other MCP clients by running via npx and requires a Blip API key for authentication.
The server provides specific tools to handle the entire lifecycle of a temporary inbox. You can use create_inbox to set up a new address with a custom slug or TTL, list_inboxes to see active accounts, and delete_inbox to remove them. For interacting with content, the read_email tool accesses bodies and attachments, while extract_codes specifically pulls OTP codes and verification links from the most recent message. The wait_for_email tool allows the agent to poll for new arrivals with a default timeout of 60 seconds.
What you can do with it
- 1Automate account verificationAsk the agent to create a new email address and retrieve a verification code for a website sign-up.
- 2Retrieve password reset linksInstruct the AI to monitor an inbox for a password reset email and pull the specific link needed.
- 3Manage active temporary inboxesRequest a summary of all currently active disposable email accounts and their recent messages.
Written from the project's README. Every use case is checked against a quote from it.
How to install Blip MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Blip MCP in Claude Code
$ claude mcp add --env 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' email -- npx -y @useblip/emailInstall Blip MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@useblip/email"
],
"env": {
"BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
}
}
}
}Install Blip MCP in VS Code
.vscode/mcp.json
{
"servers": {
"email": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@useblip/email"
],
"env": {
"BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
}
}
}
}Install Blip MCP in VS Code CLI
$ code --add-mcp '{"name":"email","type":"stdio","command":"npx","args":["-y","@useblip/email"],"env":{"BLIP_API_KEY":"<YOUR_BLIP_API_KEY>"}}'Install Blip MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@useblip/email"
],
"env": {
"BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
}
}
}
}Install Blip MCP in Codex
$ codex mcp add email --env 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' -- npx -y @useblip/emailInstall Blip MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.email] command = "npx" args = ["-y", "@useblip/email"] [mcp_servers.email.env] BLIP_API_KEY = "<YOUR_BLIP_API_KEY>"
Install Blip MCP in Gemini CLI
$ gemini mcp add -s user -e 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' email npx -- -y @useblip/emailInstall Blip MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@useblip/email"
],
"env": {
"BLIP_API_KEY": "<YOUR_BLIP_API_KEY>"
}
}
}
}Blip MCP tools 7
Detected from the READMEcreate_inboxlist_inboxesget_inboxread_emailextract_codeswait_for_emaildelete_inbox
| create_inbox | — | |
| list_inboxes | — | |
| get_inbox | — | |
| read_email | — | |
| extract_codes | — | |
| wait_for_email | — | |
| delete_inbox | — |
Configuration
BLIP_API_KEYRequiredSecretYour Blip API key
| Name | Description | |
|---|---|---|
| BLIP_API_KEY | Your Blip API key | RequiredSecret |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableblipemail/blip is public and reachablegithub.com/blipemail/blip ↗Pass
- Package names this repository as its source@useblip/email names blipemail/blip as sourcenpmjs.com/package/@useblip/email ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-02github.com/blipemail/blip ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @useblip/emailPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@useblip/email
MCP server for Blip disposable email. Create inboxes, receive emails, and extract OTP codes — all from your AI agent.
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"blip": {
"command": "npx",
"args": ["-y", "@useblip/email"],
"env": {
"BLIP_API_KEY": "blip_ak_..."
}
}
}
}
Claude Code
claude mcp add blip -- npx -y @useblip/email
Set your API key:
export BLIP_API_KEY=blip_ak_...
Other MCP clients
Run the server directly:
BLIP_API_KEY=blip_ak_... npx @useblip/email
Getting an API key
- Sign in at app.useblip.email
- Open app.useblip.email/tokens and create an API key
Any signed-in Blip account can create one key. The Agent tier gives unlimited keys.
Tools
| Tool | Description |
|---|---|
create_inbox |
Create a disposable email inbox with optional custom slug, domain, and TTL |
list_inboxes |
List all active inboxes |
get_inbox |
Get inbox details and list of received emails |
read_email |
Read full email content (body, headers, attachments) |
extract_codes |
Extract OTP codes and verification links from the latest email |
wait_for_email |
Poll until an email arrives (configurable timeout, default 60s) |
delete_inbox |
Delete an inbox and all its emails |
Example prompts
- "Create a disposable email and sign up for example.com, then give me the verification code"
- "Make an inbox, wait for the password reset email, and extract the link"
- "List my active inboxes and show me the latest emails"
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
BLIP_API_KEY |
Yes | — | Your Blip API key |
BLIP_API_URL |
No | https://api.useblip.email |
API base URL (for self-hosted) |
License
Blip MCP questions
How do I add Blip MCP to Claude Code?
Run claude mcp add --env 'BLIP_API_KEY=<YOUR_BLIP_API_KEY>' email -- npx -y @useblip/email in your terminal. Add --scope user to make it available in every project.
How do I add Blip MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Blip MCP provide?
It exposes 7 tools, including create_inbox, list_inboxes, get_inbox, read_email, extract_codes.
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.