Warmerly MCP server
Connect any AI assistant to your Warmerly workspace.
Website ·
Docs ·
Claude Code plugin
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):
/plugin marketplace add WarmerlyApp/claude-plugin
/plugin install warmerly@warmerly
Or add just the server:
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):
{
"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):
{
"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):
{
"mcpServers": {
"warmerly": { "serverUrl": "https://app.warmerly.com/api/mcp" }
}
}
OpenAI Codex CLI
codex mcp add warmerly --url https://app.warmerly.com/api/mcp
codex mcp login warmerly
Or in ~/.codex/config.toml:
[mcp_servers.warmerly]
url = "https://app.warmerly.com/api/mcp"
Gemini CLI
gemini mcp add --transport http warmerly https://app.warmerly.com/api/mcp
Or in ~/.gemini/settings.json (note httpUrl, not url):
{
"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:
{
"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:
{
"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.
| 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