Vanish Email MCP Server

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.

Related MCP server: IMAP MCP Server

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