MCP Connector

Integrate Smartlead Email Campaigns with AI

Manage Smartlead email campaigns, leads, analytics, and client accounts via AI - full feature set enabled, no license key needed.

Works with smartleadn8nclaude

91
Spark score
out of 100
Updated Jul 2025
Version 1.0.0
Models
universal

Add to Favorites

Why it matters

Connect AI assistants and automation tools to Smartlead's email marketing platform. Streamline campaign management, lead tracking, and analytics for enhanced outreach.

Outcomes

What it gets done

01

Download campaign data and analytics.

02

View download statistics with filtering.

03

Manage email campaigns and leads.

04

Integrate with n8n for automated workflows.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-smartlead | bash

Capabilities

Tools your agent gets

smartlead_download_campaign_data

Download campaign data with tracking, supporting analytics, leads, sequences, or full export to JSON/CSV.

smartlead_view_download_statistics

View download statistics filtered by time period and grouped by various dimensions.

Overview

Smartlead MCP Server

Smartlead Simplified MCP Server gives an AI assistant full access to Smartlead email campaign/lead management, analytics, Smart Delivery, client management, and download tracking, with all features enabled by default and no license key required. Use it for AI or n8n-driven Smartlead email campaign management. Requires a Smartlead API key configured interactively or via environment variable.

What it does

Smartlead Simplified MCP Server gives an AI assistant a simplified interface to Smartlead's email marketing platform, covering campaign and lead management, statistics/analytics, Smart Delivery, webhooks, client management, Smart Senders, and download tracking. All features are enabled by default with no license key required.

When to use - and when NOT to

Use it when you want an AI assistant to manage Smartlead campaigns and leads, pull analytics, download campaign data (analytics, leads, sequence, or full export) as JSON or CSV, or check download statistics grouped by type/format/campaign/date. It works with both Claude (stdio) and n8n (SSE transport) integration. Do not use it without a Smartlead API key - the first run prompts for it interactively, or it can be supplied non-interactively via --api-key or the SMARTLEAD_API_KEY environment variable.

Capabilities

  • Campaign and lead management across Smartlead campaigns.
  • Statistics and analytics on campaign performance.
  • Smart Delivery and webhook configuration.
  • Client management for agency/multi-client Smartlead accounts.
  • Smart Senders configuration.
  • smartlead_download_campaign_data: download campaign data with campaign_id, download_type (analytics, leads, sequence, full_export), format (json or csv), and optional user_id.
  • smartlead_view_download_statistics: view download stats by time_period (all/today/week/month) and group_by (type/format/campaign/date).

All downloads are tracked locally in ~/.smartlead-mcp/downloads.json for analytics.

How to install

npm install smartlead-mcp-server@1.2.1
# or run directly with npx
npx smartlead-mcp-server start

Or install automatically for Claude Desktop via Smithery:

npx -y @smithery/cli install @jean-technologies/smartlead-mcp-server-local --client claude

Claude configuration:

{
  "mcpServers": {
    "smartlead": {
      "command": "npx",
      "args": ["smartlead-mcp-server", "start"],
      "env": { "SMARTLEAD_API_KEY": "your_api_key_here" }
    }
  }
}

For n8n, run npx smartlead-mcp-server sse and configure the MCP Client node with SSE URL http://localhost:3000/sse and message URL http://localhost:3000/message. Run npx smartlead-mcp-server config to set up credentials interactively.

Who it's for

Cold email and outbound marketing teams using Smartlead who want an AI assistant or n8n workflow to manage campaigns, leads, and analytics conversationally instead of the Smartlead dashboard.

Source README

MseeP.ai Security Assessment Badge

Smartlead Simplified MCP Server

smithery badge

This application provides a simplified interface to the Smartlead API, allowing AI assistants and automation tools to interact with Smartlead's email marketing features. We welcome contribution from the community.

Licensing: All features are now enabled by default with maximum permissiveness! No license key required.

For developer details: See DEVELOPER_ONBOARDING.md

Quick Start

Installation

npm install smartlead-mcp-server@1.2.1

or use directly with npx (no installation needed):

Installing via Smithery

To install Smartlead Campaign Management Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jean-technologies/smartlead-mcp-server-local --client claude

With Claude:

npx smartlead-mcp-server start

With n8n:

npx smartlead-mcp-server sse

First run will prompt for your Smartlead API Key. No license key is required.

Integration Examples

Claude Extension:

{
  "mcpServers": {
    "smartlead": {
      "command": "npx",
      "args": ["smartlead-mcp-server", "start"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      }
    }
  }
}

n8n Setup:

  1. Start the server: npx smartlead-mcp-server sse
  2. Configure n8n MCP Client node with:
    • SSE URL: http://localhost:3000/sse
    • Message URL: http://localhost:3000/message

Available Features

All features are now enabled by default, including:

  • Campaign & Lead Management
  • Statistics and Analytics
  • Smart Delivery & Webhooks
  • n8n Integration
  • Client Management
  • Smart Senders
  • Download Tracking and Analytics

New Download Tracking Features

This release adds new download tracking capabilities:

Download Campaign Data

Download campaign data with tracking using the smartlead_download_campaign_data tool:

{
  "campaign_id": 12345,
  "download_type": "analytics", // "analytics", "leads", "sequence", "full_export"
  "format": "json", // "json" or "csv"
  "user_id": "optional-user-identifier"
}

View Download Statistics

View download statistics using the smartlead_view_download_statistics tool:

{
  "time_period": "all", // "all", "today", "week", "month"
  "group_by": "type" // "type", "format", "campaign", "date"
}

All downloads are tracked in ~/.smartlead-mcp/downloads.json for analytics.

Need Help?

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.