instantly-cli

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

36|7|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/bcharleson/instantly-cli --skill instantly-cli-bcharleson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: instantly-cli
Source: https://github.com/bcharleson/instantly-cli
Command: npx skills add https://github.com/bcharleson/instantly-cli --skill instantly-cli-bcharleson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, zod, @modelcontextprotocol/sdk, @inquirer/prompts.

What problem does it solve? Managing cold email outreach through the Instantly.ai web dashboard requires manual clicking and cannot be scripted or integrated into automated workflows. This Skill gives AI agents and terminal users programmatic access to the full Instantly V2 API — 156 commands across 31 groups — so campaigns, leads, sending accounts, deliverability tests, and inbox replies can be managed from the command line or through MCP tools. ## Core Features & Use Cases - Campaign and lead automation: Create campaigns, bulk-add up to 1,000 leads, activate or pause sequences, and monitor sending status without opening a browser. - Deliverability and account health: Run DNS/SMTP/IMAP checks, manage warmup, test inbox placement, and track per-campaign or per-account analytics. - Multi-workspace profile isolation: Agencies bind each client to a named profile with fail-closed workspace verification, so writes never hit the wrong workspace. - Use Case: An agency operator asks an AI assistant to list campaigns for client-a, check unread replies, and respond to interested leads — the assistant uses the client-a profile, confirms the bound workspace via status, and executes the commands with JSON output. ## Quick Start Install the CLI with npm, export your Instantly API key as an environment variable, then ask the assistant to run instantly status and list your campaigns.

Frequently Asked Questions about instantly-cli

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

FAQPage Schema
How do I manage Instantly.ai campaigns from the command line?▼

Install instantly-cli via npm, set INSTANTLY_API_KEY, then use commands like instantly campaigns list, campaigns create, and campaigns activate. All commands output JSON to stdout for scripting.

How do I connect Instantly to Claude or Cursor as MCP tools?▼

Run instantly mcp to start the built-in MCP server, then register it in your MCP client config with npx instantly-cli mcp and your API key or INSTANTLY_PROFILE. This exposes all 156 commands as MCP tools.

Can I manage multiple Instantly workspaces or agency clients?▼

Yes, create a named profile per client with instantly login --profile <client>. Each process uses one profile, and write commands require --workspace matching the bound workspace UUID to prevent cross-client mistakes.

Does the Instantly CLI support bulk lead imports?▼

Yes, instantly leads bulk-add accepts a JSON array of up to 1,000 leads per call, including custom variables. Leads can also be moved between campaigns, merged, and assigned to sending accounts.

Why does my campaign follow-up email send on the same day?▼

A multi-step sequence with delay 0 or a missing delay on a non-last step is rejected because the follow-up would send the same day. Set delay and delay_unit on each step; delay on step N waits before step N+1.