MCP Setup

Install

The Emailens MCP server is published to npm as @emailens/mcp. No local clone needed.

Claude Code

claude mcp add emailens -- npx -y @emailens/mcp

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "emailens": {
      "command": "npx",
      "args": ["-y", "@emailens/mcp"]
    }
  }
}

Restart Claude Desktop. The 9 Emailens tools will appear in the tools menu.

With API Key (optional)

To unlock screenshots and sharing, add your API key:

{
  "mcpServers": {
    "emailens": {
      "command": "npx",
      "args": ["-y", "@emailens/mcp"],
      "env": {
        "EMAILENS_API_KEY": "ek_live_..."
      }
    }
  }
}

Get your free API key at emailens.dev/settings/api-keys. Free plan includes 30 previews/day.

Remote Server (no install)

Don't want to install anything locally? Use the hosted endpoint. All analysis runs server-side — no npm or Node.js required. Requires an API key.

{
  "mcpServers": {
    "emailens": {
      "url": "https://emailens.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ek_live_..."
      }
    }
  }
}

The remote server exposes the same 7 analysis tools as the local server. Rate-limited at 100 requests/minute per key. Does not consume your preview quota.

Also available on Smithery.

Using Bun

If you prefer Bun over npx for the local server:

{
  "mcpServers": {
    "emailens": {
      "command": "bunx",
      "args": ["@emailens/mcp"]
    }
  }
}

Local vs Remote

Use local if you want the full 9-tool experience with offline support. Use remote for zero-install convenience.

Verify connection

After connecting, ask your AI: "List the supported email clients using emailens."

It should call the list_clients tool and return all 15 supported clients.