dropmail-mcp

MCP server for DropMail — gives AI assistants tools to create temporary email addresses and receive mail automatically.

Installation

Install with pip or pipx (recommended for use in MCP client configs):

pip install dropmail-mcp
# or
pipx install dropmail-mcp

You can also run without installing using uvx — handy for a quick test in the terminal:

uvx dropmail-mcp --token YOUR_TOKEN

Note: uvx may not work reliably when launched as a subprocess by MCP clients (Claude Desktop, VS Code, Copilot CLI). If your client shows "Connection closed", use pip/pipx instead.

Configuration

To use the public service, no DROPMAIL_BASE_URL override is needed — it defaults to https://dropmail.me/api/graphql.

DEBUG log level records the full GraphQL request (minified query + variables) and response body after each call — useful for troubleshooting.

Claude Desktop setup

{
  "mcpServers": {
    "dropmail": {
      "command": "dropmail-mcp",
      "env": {
        "DROPMAIL_TOKEN": "your-token-here"
      }
    }
  }
}

VS Code / GitHub Copilot IDE setup

Add to .vscode/mcp.json in your workspace (VS Code 1.99+, agent mode):

{
  "servers": {
    "dropmail": {
      "type": "stdio",
      "command": "dropmail-mcp",
      "env": {
        "DROPMAIL_TOKEN": "${input:dropmail-token}"
      }
    }
  },
  "inputs": [
    {
      "id": "dropmail-token",
      "type": "promptString",
      "description": "DropMail API token (obtain at dropmail.me/api/)",
      "password": true
    }
  ]
}

VS Code will prompt for the token securely — it is never stored in plain text.

GitHub Copilot CLI setup

Edit ~/.copilot/mcp-config.json (create if it doesn't exist):

{
  "mcpServers": {
    "dropmail": {
      "command": "dropmail-mcp",
      "env": {
        "DROPMAIL_TOKEN": "${DROPMAIL_TOKEN}"
      }
    }
  }
}

Set DROPMAIL_TOKEN in your shell profile (~/.bashrc, ~/.zshrc, etc.), or run /mcp add inside the Copilot CLI session to configure it interactively.

Tools

Example prompts

• "Give me a temp email and wait for the confirmation from example.com"
• "Sign me up for the newsletter at example.com using a throwaway address"
• "I need to sign up for a product trial on example.com — give me a .com temp email, wait for their email, and pull out the activation code"
• "Check if the password reset email has arrived and give me the link"

Running tests

cd mcp
pip install -e ".[dev]"

# Unit tests only
pytest tests/test_client.py tests/test_tools.py

# Integration tests (requires a running DropMail instance)
DROPMAIL_TOKEN=mytoken pytest tests/test_integration.py

License

MIT