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.
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
Download campaign data and analytics.
View download statistics with filtering.
Manage email campaigns and leads.
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
Download campaign data with tracking, supporting analytics, leads, sequences, or full export to JSON/CSV.
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 withcampaign_id,download_type(analytics, leads, sequence, full_export),format(json or csv), and optionaluser_id.smartlead_view_download_statistics: view download stats bytime_period(all/today/week/month) andgroup_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
Smartlead Simplified MCP Server
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:
- Start the server:
npx smartlead-mcp-server sse - Configure n8n MCP Client node with:
- SSE URL:
http://localhost:3000/sse - Message URL:
http://localhost:3000/message
- SSE URL:
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?
- Run
npx smartlead-mcp-server configto set up credentials - Use
--api-keyoption for non-interactive setup - Contact: jonathan@jeantechnologies.com
- Website: jeantechnologies.com
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.
