Warmerly MCP server

Connect any AI assistant to your Warmerly workspace.
Website · Docs · Claude Code plugin

Code

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

A remote Model Context Protocol 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 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

ChatGPT

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.

Claude (claude.ai and the desktop app)

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.

Claude Code

Install the plugin (server plus four workflow skills):

text

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

Or add just the server:

Terminal

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

Then run /mcp and sign in.

Cursor

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

config.json

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

Open Settings → MCP and sign in when prompted.

VS Code (GitHub Copilot agent mode)

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

config.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.

Windsurf

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

config.json

{
  "mcpServers": {
    "warmerly": { "serverUrl": "https://app.warmerly.com/api/mcp" }
  }
}

OpenAI Codex CLI

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"

Gemini CLI

bash

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

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

config.json

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

Sign-in starts automatically; /mcp auth warmerly repeats it.

Cline

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

config.json

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

Any client that only supports local (stdio) servers

Bridge with mcp-remote, for example in claude_desktop_config.json:

config.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.

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.

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 · Terms