instantly-cli

Manage Instantly.ai cold email campaigns, leads, accounts, and analytics via CLI and MCP tools.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill instantly-cli-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instantly-cli
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/instantly-cli
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill instantly-cli-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing cold email outreach at scale requires constant switching between the Instantly.ai dashboard and your own scripts or AI assistants. This Skill provides a complete API reference and command structure for the Instantly CLI, letting you automate campaigns, leads, sending accounts, deliverability testing, and inbox replies directly from the terminal or an MCP-connected AI assistant. ## Core Features & Use Cases - Campaign & Lead Automation: Create campaigns, bulk-add up to 1,000 leads, activate or pause sending, and move or merge leads across campaigns using 156 commands across 31 API groups. - Deliverability & Infrastructure Management: Run DNS/SMTP/IMAP health checks, enable warmup, execute inbox placement tests, and pull per-campaign or daily analytics. - Unified Inbox & AI Integration: Read and reply to emails from the unified inbox, manage webhooks for real-time events, and expose every command as an MCP tool for Claude, Cursor, or VS Code. - Use Case: Launch a new outbound campaign end-to-end — create the campaign, bulk-import leads, activate sending, then poll unread replies and respond — all through scripted CLI commands or an AI agent. ## Quick Start Ask the AI to list your Instantly campaigns and show their status using the instantly CLI with your INSTANTLY_API_KEY environment variable set.

Frequently Asked Questions about instantly-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch a cold email campaign with the Instantly CLI?

Create the campaign with instantly campaigns create, add prospects using instantly leads bulk-add with a JSON array of leads, then start sending with instantly campaigns activate. All commands output JSON for scripting.

How do I connect the Instantly CLI to Claude or Cursor?

Run instantly mcp to start the built-in MCP server, then register it in your assistant's MCP config with the command npx instantly-cli mcp and your INSTANTLY_API_KEY in the env block. This exposes all 156 commands as native tools.

Does the Instantly CLI require interactive login for scripts?

No. Set the INSTANTLY_API_KEY environment variable or pass --api-key per command for fully non-interactive use. Interactive login via instantly login is optional and saves the key to ~/.instantly/config.json.

Why do my email bodies render as one block in Instantly?

Instantly renders bodies as HTML, so raw newline characters collapse. The CLI auto-converts plain text to HTML in email reply, forward, and leads bulk-add body variables, but direct API calls must use div-wrapped paragraphs.

What are the Instantly API rate limits when using the CLI?

The workspace-wide limit is 100 requests per 10 seconds and 600 per minute, shared across all API keys. The CLI handles retries automatically with exponential backoff and respects Retry-After headers.