# Warmerly

**Category:** 💬 Communication  
**Repository:** https://github.com/WarmerlyApp/mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/warmerly

## Description
Cold email outreach: find leads, launch campaigns, fix deliverability, answer replies.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "warmerly": {
    "command": "npx",
    "args": ["-y","warmerly"]
  }
}
```

## Documentation & README

<p align="center">
  <img src="https://raw.githubusercontent.com/WarmerlyApp/mcp/HEAD/.github/warmerly-icon.png" alt="Warmerly" width="96" height="96">
</p>

<h1 align="center">Warmerly MCP server</h1>

<p align="center">
  Connect any AI assistant to your Warmerly workspace.<br>
  <a href="https://warmerly.com/ai">Website</a> ·
  <a href="https://docs.warmerly.com/ai">Docs</a> ·
  <a href="https://github.com/WarmerlyApp/claude-plugin">Claude Code plugin</a>
</p>

```
https://app.warmerly.com/api/mcp
```

<p align="center">
  <a href="https://cursor.com/en/install-mcp?name=warmerly&config=eyJ1cmwiOiJodHRwczovL2FwcC53YXJtZXJseS5jb20vYXBpL21jcCJ9"><img alt="Add to Cursor" src="https://cursor.com/deeplink/mcp-install-dark.svg" height="32"></a>
  <a href="https://vscode.dev/redirect/mcp/install?name=warmerly&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.warmerly.com%2Fapi%2Fmcp%22%7D"><img alt="Install in VS Code" src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white" height="32"></a>
</p>

A remote [Model Context Protocol](https://modelcontextprotocol.io) server (streamable HTTP, OAuth 2.1).
Sign in with your normal Warmerly account and choose one workspace; the connection can only see and
act in that workspace. **Every Warmerly plan can connect, including Free.** No API key needed.

This repo holds copy-paste setup for each client. The server itself is hosted by Warmerly and listed
in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=com.warmerly) as
`com.warmerly/warmerly` (`server.json` here).

## What you can ask

- "Find UK marketing agencies with 10–50 staff and build a two-step campaign for them."
- "Which of my mailboxes are unhealthy, and why?"
- "Check SPF, DKIM, DMARC and MX for acme.com and tell me what to fix."
- "Show me replies that need an answer and draft a response to each."
- "Pause every campaign that's bouncing above 3%."
- "Verify jane@acme.com."

## Setup

<details open>
<summary><b>ChatGPT</b></summary>

Search for **Warmerly** in the ChatGPT plugin directory. Until it's listed, turn on developer mode
(Plus, Pro, Business, Enterprise or Edu), then **Plugins → Add → Create MCP App** with the URL
above and **OAuth** authentication.
</details>

<details open>
<summary><b>Claude (claude.ai and the desktop app)</b></summary>

**Settings → Connectors → Add custom connector**, paste the URL above, then **Connect** and sign in.
On Team and Enterprise plans an owner adds it under Organization settings → Connectors.
</details>

<details>
<summary><b>Claude Code</b></summary>

Install the plugin (server plus four workflow skills):

```text
/plugin marketplace add WarmerlyApp/claude-plugin
/plugin install warmerly@warmerly
```

Or add just the server:

```bash
claude mcp add --transport http warmerly https://app.warmerly.com/api/mcp
```

Then run `/mcp` and sign in.
</details>

<details>
<summary><b>Cursor</b></summary>

`~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "warmerly": { "url": "https://app.warmerly.com/api/mcp" }
  }
}
```

Open **Settings → MCP** and sign in when prompted.
</details>

<details>
<summary><b>VS Code (GitHub Copilot agent mode)</b></summary>

Run **MCP: Add Server**, or put this in `.vscode/mcp.json` (or **MCP: Open User Configuration** for
every workspace):

```json
{
  "servers": {
    "warmerly": { "type": "http", "url": "https://app.warmerly.com/api/mcp" }
  }
}
```

A browser window opens to sign in the first time a tool is used.
</details>

<details>
<summary><b>Windsurf</b></summary>

`mcp_config.json` (`~/.codeium/windsurf/mcp_config.json` on most installs; open it from the MCP
settings panel to be sure):

```json
{
  "mcpServers": {
    "warmerly": { "serverUrl": "https://app.warmerly.com/api/mcp" }
  }
}
```
</details>

<details>
<summary><b>OpenAI Codex CLI</b></summary>

```bash
codex mcp add warmerly --url https://app.warmerly.com/api/mcp
codex mcp login warmerly
```

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.warmerly]
url = "https://app.warmerly.com/api/mcp"
```
</details>

<details>
<summary><b>Gemini CLI</b></summary>

```bash
gemini mcp add --transport http warmerly https://app.warmerly.com/api/mcp
```

Or in `~/.gemini/settings.json` (note `httpUrl`, not `url`):

```json
{
  "mcpServers": {
    "warmerly": { "httpUrl": "https://app.warmerly.com/api/mcp" }
  }
}
```

Sign-in starts automatically; `/mcp auth warmerly` repeats it.
</details>

<details>
<summary><b>Cline</b></summary>

MCP Servers → **Remote Servers**, or in the JSON config:

```json
{
  "mcpServers": {
    "warmerly": {
      "type": "streamableHttp",
      "url": "https://app.warmerly.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
</details>

<details>
<summary><b>Any client that only supports local (stdio) servers</b></summary>

Bridge with [mcp-remote](https://github.com/geelen/mcp-remote), for example in
`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "warmerly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.warmerly.com/api/mcp"]
    }
  }
}
```

A browser opens to sign in on first connect. Delete `~/.mcp-auth/` to sign in again.
</details>

## Tools

| Area | Tools |
| --- | --- |
| Account and docs | `get_account_overview`, `search_docs`, `read_doc`, `get_connect_mailbox_link` |
| Mailboxes and deliverability | `list_mailboxes`, `get_mailbox_health`, `set_warmup`, `update_mailbox_settings`, `check_domain`, `run_placement_test` |
| Leads and email data | `search_leads`, `count_leads`, `verify_email`, `find_email`, `get_find_email_result`, `suppress_emails` |
| Campaigns | `list_campaigns`, `get_campaign`, `create_campaign`, `set_campaign_sequence`, `update_campaign_settings`, `add_leads`, `add_leads_from_search`, `launch_campaign`, `pause_campaign`, `resume_campaign`, `get_campaign_stats` |
| Inbox | `list_conversations`, `get_conversation`, `draft_reply`, `send_reply`, `categorize_message` |
| Transactional email | `list_sending_domains`, `list_transactional_emails`, `get_transactional_email`, `send_transactional_email` |

Full descriptions: [docs.warmerly.com/ai](https://docs.warmerly.com/ai#tools).

## Safety

- **The same rules as the dashboard.** Plan limits, the suppression list, mailbox health checks and
  campaign readiness checks apply to every call.
- **Rate limited:** 60 calls a minute per connection; sends share a tighter 20 a minute.
- **Audited:** every write is logged in the workspace audit log with the connecting app's name.
- **No passwords through the AI:** mailboxes are connected in the Warmerly dashboard, never through
  a tool.
- **Revocable:** Settings → Connected apps in Warmerly cuts a connection off immediately.

## Support

hello@warmerly.com · [Privacy](https://warmerly.com/privacy) · [Terms](https://warmerly.com/terms)