Vanish Email Server

npm version Build & Release

A Model Context Protocol (MCP) server for Vanish Email, allowing AI agents to manage temporary email addresses and read incoming messages.

Features

• Get Domains: List available email domains.
• Generate Email: Create unique temporary email addresses.
• List Emails: Check for incoming messages in a mailbox.
• Get Email: Read the full content of a specific email, including attachments.
• Delete Email/Mailbox: Clean up temporary data.

Installation & Configuration

1. Claude Desktop

Add this to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
	"mcpServers": {
		"vanish-email": {
			"command": "npx",
			"args": ["-y", "@vanish-email/mcp"],
			"env": {
				"VANISH_API_KEY": "your_api_key_here"
			}
		}
	}
}

2. Cursor

Add to ~/.cursor/mcp.json (or %USERPROFILE%\.cursor\mcp.json on Windows):

{
	"mcpServers": {
		"vanish-email": {
			"command": "npx",
			"args": ["-y", "@vanish-email/mcp"],
			"env": {
				"VANISH_API_KEY": "your_api_key_here"
			}
		}
	}
}

3. VS Code (GitHub Copilot)

Ensure chat.mcp.enabled is set to true in settings. Then add to your workspace or user mcp.json:

{
	"mcpServers": {
		"vanish-email": {
			"command": "npx",
			"args": ["-y", "@vanish-email/mcp"],
			"env": {
				"VANISH_API_KEY": "your_api_key_here"
			}
		}
	}
}

4. Claude Code (CLI)

Run the following command:

claude mcp add vanish-email --scope project --env VANISH_API_KEY=your_api_key_here -- npx -y @vanish-email/mcp

5. Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
	"mcpServers": {
		"vanish-email": {
			"command": "npx",
			"args": ["-y", "@vanish-email/mcp"],
			"env": {
				"VANISH_API_KEY": "your_api_key_here"
			}
		}
	}
}

Available Tools

• get-domains: Get list of available email domains.
• generate-email: Generate a unique temporary email address.
  • domain (optional): Specific domain to use.
  • prefix (optional): Prefix for the email address.
• list-emails: List emails for a mailbox address.
  • address: The email address to check.
  • limit (optional): Max emails to return.
• get-email: Get full details of a specific email.
  • emailId: The ID of the email to retrieve.
• delete-email: Delete a specific email.
  • emailId: The ID of the email to delete.
• delete-mailbox: Delete all emails in a mailbox.
  • address: The email address of the mailbox to clear.

License

MIT