> ## Documentation Index
> Fetch the complete documentation index at: https://help.emaillove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Love MCP

> Research real marketing emails from ChatGPT, Claude, Codex or Cursor. Free with an Email Love account.

The Email Love MCP connects your AI assistant to Email Love's library of real marketing emails. Ask it to compare offers, walk a brand's lifecycle journey, pull brand insights or find design inspiration, and every example links back to its page on [emaillove.com](https://emaillove.com).

Connect it once with your Email Love sign-in. The library tools are free with an Email Love account, and they are read-only. Product overview: [emaillove.com/mcp](https://emaillove.com/mcp).

If you use Email Love Builder, the same connection also has the Builder's tools, named `builder_…`. They build and edit emails in your Builder account. See [Use the Builder from an AI agent](https://help.emaillove.com/builder/api/agent-tools.md).

> [!NOTE]
>
> **Want an agent to build emails from your own design system?** In Email Love Builder, use the Builder tools on this same connection: see [Use the Builder from an AI agent](https://help.emaillove.com/builder/api/agent-tools.md). To build on your Figma canvas instead, see [Build with the Figma MCP](https://help.emaillove.com/plugin/ai/agents-in-figma.md).

## What it does

Once connected, your AI assistant can:

* **Search the library** by keyword, brand, or category.
* **Open emails** with their subject line, sender, screenshot, categories and editorial notes, and retrieve the full HTML.
* **Walk lifecycle journeys** to see how a brand sequences its welcome flow, abandoned cart, win-back and more.
* **Read brand insights**: send cadence and timing, ESP, subject-line patterns and content signals.
* **Read your own data**: your collections, liked emails, and the brands you follow on [emaillove.com](https://emaillove.com).
* **Render emails inline** as visual cards in clients that support MCP Apps.
* **Build emails in Email Love Builder**, if you use it: create and edit emails from your design system, check, translate and export them, and push them to your sending platform. See [Use the Builder from an AI agent](https://help.emaillove.com/builder/api/agent-tools.md).

## Cost and limits

The MCP server and the [REST API](https://dev.emaillove.com/docs/api) are free for now with an Email Love account: every library tool and the whole library, with no monthly limit. The Builder tools follow your Builder plan, as in the Builder. Requests are limited per minute so one client can't overload the service; see [Rate limits](https://dev.emaillove.com/docs/limits).

## Before you start

You need:

* A free **Email Love account** (sign up at [emaillove.com](https://emaillove.com), no credit card needed).
* An **MCP client that supports remote servers with sign-in**: ChatGPT, Claude (Claude.ai, the desktop app, Cowork and Claude Code), Codex, Cursor, and others.

The server URL is always:

```text theme={null}
https://chat.emaillove.com/mcp
```

Name the connection **Email Love** wherever you add it, so it is easy to spot if you check later whether you are already connected.

## Connect your AI client

> [tab] ChatGPT
>
> Check **Plugins → Installed** first so you do not add Email Love twice.
>
> 1. Open **Plugins** in the sidebar (or go to chatgpt.com/plugins), click **+**, then **Add custom MCP server**.
> 2. Name it **Email Love**, paste the server URL, and choose **OAuth** for authentication.
> 3. Select **I understand and want to continue**, then **Create as a plugin**. Sign in to Email Love when ChatGPT asks, and click **Allow**.
> 4. In a new chat, type **@** and choose **Email Love**.
>
> Custom MCP plugins need a paid ChatGPT plan and work on the web. In Business, Enterprise and Edu workspaces, an admin has to allow them first.

> [tab] Claude
>
> 1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.
> 2. Name it **Email Love**, paste the server URL, and click **Continue**.
> 3. Choose **Sign in now**, choose **Register automatically** for the OAuth client, and click **Add**. Sign in to Email Love and click **Allow**.
> 4. In a new chat, open **+ → Connectors** and turn on **Email Love**.
>
> The connector also appears in the Claude desktop and mobile apps, in Cowork, and in Claude Code when it is signed in with your Claude account. Free Claude plans allow one custom connector. On Team and Enterprise plans, an Owner adds it under **Organization settings → Connectors** first; members then click **Connect**.

> [tab] Claude Code
>
> 1. Run this once in your terminal:
>
>    ```bash theme={null}
>    claude mcp add --scope user --transport http email-love https://chat.emaillove.com/mcp
>    ```
>
> 2. In Claude Code, run `/mcp`, choose **email-love**, and sign in to Email Love in the browser.
>
> Already connected? Run `claude mcp list`. If you added Email Love on claude.ai, it is listed as **claude.ai Email Love** and you can skip step 1.

> [tab] Codex
>
> The Codex CLI, the IDE extension and the ChatGPT desktop app share one MCP configuration, so these commands connect all three.
>
> ```bash theme={null}
> codex mcp add email-love --url https://chat.emaillove.com/mcp
> codex mcp login email-love
> ```
>
> Then start a new Codex task so the tools load.
>
> Prefer the desktop app? Open **Settings → MCP servers → Add server**, choose **Streamable HTTP**, paste the URL, save, click **Restart**, then **Authenticate**. The Email Love plugin may already include this connection: run `codex mcp list` first and skip the commands if this URL is listed.

> [tab] Cursor
>
> 1. Add this to `~/.cursor/mcp.json`, save it, and restart Cursor:
>
>    ```json theme={null}
>    {
>      "mcpServers": {
>        "email-love": { "url": "https://chat.emaillove.com/mcp" }
>      }
>    }
>    ```
>
> 2. Cursor shows that email-love needs to sign in. Follow the prompt, sign in to Email Love, and click **Allow**.
>
> Check **Customize → MCPs** first: if email-love is listed, there is nothing to add.

> [tab] Other clients
>
> Any MCP client that supports remote servers over HTTP with OAuth works the same way: add `https://chat.emaillove.com/mcp` as the server URL, sign in to Email Love, and click **Allow**.
>
> For older clients that only support stdio, you can bridge with `mcp-remote`:
>
> ```bash theme={null}
> npx mcp-remote https://chat.emaillove.com/mcp
> ```

> [!TIP]
>
> Using Claude Code, Codex or Cursor? The connection chooser on [emaillove.com/mcp](https://emaillove.com/mcp#connect) has a **Copy setup brief** button. Paste the brief into your agent and it checks for an existing connection, connects Email Love, tells you when to sign in, and runs a first piece of research.

**How to tell it worked:** ask your assistant which Email Love tools it has. You should see tools such as `search_emails`, `fetch_email`, `get_journey` and `get_brand_insights`.

## Try your first prompt

A few starter prompts to get a feel for it:

* *"Search Email Love for welcome emails from outdoor brands."*
* *"Show me Patagonia's full welcome journey on Email Love."*
* *"Compare abandoned-cart offers from five apparel brands, with a link to each email."*
* *"Use Email Love to find Black Friday emails from the last 12 months. Show me 5 of the most interesting."*
* *"Show me my Email Love collections."*
* *"What have the brands I follow on Email Love sent this week?"*
* *"What are Anthropic's most recent emails?"*

The agent figures out which tools to call. Email cards render inline as a carousel. Preview the actual emails, click through to the full page on [emaillove.com](http://emaillove.com), or ask the agent to fetch a specific one for more detail.

## What each tool does

You usually don't need to call these by name. Your AI agent figures out the sequence from your natural-language request. But if you want to see what's available:

| Tool | What it does |
| - | - |
| `search` / `search_emails` | Search the library by keyword, brand, or category. Returns a carousel of email cards. |
| `fetch` / `fetch_email` | Fetch the full details (subject, brand, captured-at date, preview URL) of one email by ID. |
| `get_email_html` | Fetch the full sanitized HTML source of one email by ID. Study how a real brand email is built (tables, responsive styles, footer markup) or use it as the reference for ESP templating work. |
| `search_brands` | List or filter brands available in the library. |
| `list_journeys` | List the brands that have a curated lifecycle journey (welcome, post-purchase, win-back, etc.). |
| `get_journey` | Get all emails in a specific journey for a brand, grouped by stage. |
| `get_brand_insights` | Analytics for one brand: send cadence and timing, ESP, subject-line patterns, content metrics, and deliverability. |
| `list_collections` | Lists the collections you've saved on [emaillove.com](http://emaillove.com) (signed-in users only). |
| `get_collection` | Fetches a specific collection's emails. |
| `list_liked_emails` | The emails you've favorited on [emaillove.com](http://emaillove.com). |
| `list_followed_brands` | The brands you follow on [emaillove.com](http://emaillove.com), most recent follow first. |
| `list_followed_brand_emails` | The newest emails from every brand you follow. Ask for emails since a date to see only what's new. |

If you use Email Love Builder, you also see 58 tools named `builder_…`, such as `builder_list_workspaces` and `builder_open_email`. They're listed by group in [Use the Builder from an AI agent](https://help.emaillove.com/builder/api/agent-tools.md).

## Privacy & access

* Sign-in uses your standard Email Love account, the same one you use to like and save on [emaillove.com](http://emaillove.com).
* The library tools are **read-only**: they search, browse, and fetch. They never modify your account or send anything.
* The Builder tools (`builder_…`) work in your Builder account as you, with your role there. They can create and change emails, send test emails and push to your sending platform. They can't approve or delete emails.
* Per-user tools (`list_collections`, `get_collection`, `list_liked_emails`, `list_followed_brands`, `list_followed_brand_emails`) only ever see **your own** data.
* The Email Love library itself is public. What you see in the MCP is the same set browsable on [emaillove.com](http://emaillove.com).
* To **rotate access**: delete the connector in your AI client and re-connect. To **fully revoke**: delete the connector.

## Troubleshooting

**"Authorization request blocked"**

The AI client sent a callback URL we don't recognize. As of June 2026 we support all major hosted clients (Claude, ChatGPT, Cursor, Lovable, v0), all desktop tools using loopback callbacks (Claude Code, Cowork, Cursor desktop in loopback mode), and reverse-DNS-style custom URI schemes (Cursor desktop's `cursor://anysphere.cursor-mcp/`). If you hit this with a client we should add, email [hello@emaillove.com](mailto:hello@emaillove.com) with a screenshot of the block page.

**Carousel doesn't render visually (just shows JSON or plain text)**

Some MCP clients don't support the MCP Apps UI yet. Ask the agent to "show me the first 3 emails as a list". It'll fall back to plain text with links.

**Sign-in loops back to the sign-in page**

Your browser may be blocking third-party cookies for [emaillove.com](https://emaillove.com). Allow cookies for [emaillove.com](https://emaillove.com) and try again.

**Sign-in finished on the emaillove.com sign-up page**

If you signed in to an existing account from the sign-up page's **Log in** link, the browser can stay on that page instead of returning to the **Allow** step. You are signed in, so go back to your assistant and connect again; it now goes straight to **Allow**.

**Tools don't appear after connecting**

Start a new chat or task: tools load when a conversation starts. In Claude Code run `/mcp`; in Cursor check **Customize → MCPs**. If the Claude desktop app still shows nothing, quit it completely and reopen. On macOS, use ⌘+Q rather than just closing the window.

**Email Love is listed twice**

Some installs already include a connection, such as the Email Love plugin for Codex and ChatGPT. Keep one entry that points to `https://chat.emaillove.com/mcp` and remove the other.

**Empty results when searching**

The library is large but not infinite. Try broader keywords, or browse by brand instead (`list brands`, then `show me emails from X`).

## What's coming

* **Saved searches sync.** Pull your saved searches from [emaillove.com](http://emaillove.com) directly into the AI agent.
* **Smart trend reports.** Automatic weekly trend summaries surfaced inline.

## Related Articles

* [Use the Builder from an AI agent](https://help.emaillove.com/builder/api/agent-tools.md): the Builder tools on this connection, and the other ways to connect to the Builder.
* [Build with the Figma MCP](https://help.emaillove.com/plugin/ai/agents-in-figma.md): build on-brand emails from your own Figma-synced design system with Claude or Codex.
* [Email Love API](https://dev.emaillove.com/docs/api): the same library, plus your follows, likes and collections, as a REST API for your own code.

## Need help?

Email [hello@emaillove.com](mailto:hello@emaillove.com) and we'll respond within a business day.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.