The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Warmerly listing page.
Connect any AI assistant to your Warmerly workspace.
Website ·
Docs ·
Claude Code plugin
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).
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.
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.
Install the plugin (server plus four workflow skills):
Or add just the server:
Then run /mcp and sign in.
~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
Open Settings → MCP and sign in when prompted.
Run MCP: Add Server, or put this in .vscode/mcp.json (or MCP: Open User Configuration for
every workspace):
A browser window opens to sign in the first time a tool is used.
mcp_config.json (~/.codeium/windsurf/mcp_config.json on most installs; open it from the MCP
settings panel to be sure):
Or in ~/.codex/config.toml:
Or in ~/.gemini/settings.json (note httpUrl, not url):
Sign-in starts automatically; /mcp auth warmerly repeats it.
MCP Servers → Remote Servers, or in the JSON config:
Bridge with mcp-remote, for example in
claude_desktop_config.json:
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.