The Smartlead Simplified MCP Server provides a streamlined interface to Smartlead's email marketing API, allowing you to:
Campaign Management: Create, update, schedule, retrieve, and delete campaigns; manage email sequences and settings
Lead Management: Add, update, import (bulk), delete and track leads; update lead status and view campaign associations
Analytics: Track campaign performance, download data (JSON/CSV), view statistics, and analyze by date ranges
Data Export: Export campaign leads and download various data types with built-in tracking
Integrations: Connect with AI assistants like Claude and automation tools like n8n through different server modes
Smart Features: Utilize smart delivery, webhooks, smart senders, and client management capabilities
Integrates with a license server hosted on DigitalOcean for license validation and feature access control
Uses .ENV files for configuration management, storing API keys, license information, and other settings
Uses Git for version control and repository management
Hosts code repository and provides access to the codebase
Enables integration with n8n workflows via Server-Sent Events (SSE), allowing n8n to interact with Smartlead API through the MCP server
Supports tunneling for exposing local SSE server to the internet, facilitating connections from cloud services like n8n cloud
Runs on Node.js runtime to facilitate API communications and server operations
Provides TypeScript support for development with type checking
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Smartlead Simplified MCP Server show me analytics for campaign 12345 from last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
npm install smartlead-mcp-server@1.2.1or use directly with npx (no installation needed):
To install Smartlead Campaign Management Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @jean-technologies/smartlead-mcp-server-local --client claudenpx smartlead-mcp-server startnpx smartlead-mcp-server sseFirst run will prompt for your Smartlead API Key. No license key is required.
Related MCP server: Smartlead MCP Server
{
"mcpServers": {
"smartlead": {
"command": "npx",
"args": ["smartlead-mcp-server", "start"],
"env": {
"SMARTLEAD_API_KEY": "your_api_key_here"
}
}
}
}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
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
This release adds new download tracking capabilities:
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 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.
Run npx smartlead-mcp-server config to set up credentials
Use --api-key option for non-interactive setup
Contact: jonathan@jeantechnologies.com
Website: jeantechnologies.com
This software is proprietary and confidential. Unauthorized copying, redistribution, or use of this software, in whole or in part, via any medium, is strictly prohibited without the express permission of Jean Technologies.
Copyright © 2025 Jean Technologies. All rights reserved.
Add a new lead to a campaign.
Inputs: email (required), campaign_id (required), phone, title, +4 more.
Import multiple leads into a campaign at once.
Inputs: leads (required), campaign_id (required).
Create a new campaign in Smartlead.
Inputs: name (required), client_id.
Delete a campaign permanently.
Inputs: campaign_id (required).
Delete a lead permanently.
Inputs: lead_id (required).
Export all leads data from a campaign as CSV.
Inputs: campaign_id (required).
Get details of a specific campaign by ID.
Inputs: campaign_id (required).
Fetch campaign analytics for a specific date range.
Inputs: end_date (required), start_date (required), campaign_id (required).
Fetch all campaigns that a lead belongs to.
Inputs: lead_id (required).
Fetch a campaign's sequence data.
Inputs: campaign_id (required).
Fetch analytics data for a specific email campaign sequence.
Inputs: end_date (required), start_date (required), campaign_id (required), time_zone.
Get details of a specific lead by ID.
Inputs: lead_id (required).
List all campaigns with optional filtering.
Inputs: limit, offset, status.
List leads with optional filtering by campaign or status.
Inputs: limit, offset, search, status, +3 more.
Save a sequence of emails for a campaign.
Inputs: sequence (required), campaign_id (required).
Update a campaign's schedule settings.
Inputs: campaign_id (required), end_hour, timezone, start_hour, +4 more.
Update a campaign's general settings.
Inputs: campaign_id (required), name, status, settings.
Update the status of a campaign. Use this specifically for changing a campaign's status.
Inputs: status (required), campaign_id (required).
Update an existing lead's information.
Inputs: lead_id (required), email, phone, title, +4 more.
Update a lead's status.
Inputs: status (required), lead_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 20 tools
Each tool has a clearly distinct purpose, targeting specific actions on campaigns or leads. There is no overlap, as tools like update_campaign_settings and update_campaign_schedule manage separate aspects.
All tools follow the consistent pattern 'smartlead_verb_noun' (e.g., smartlead_create_campaign, smartlead_delete_lead). No mixing of conventions, making the set predictable.
With 20 tools, the set covers campaign and lead management comprehensively. While slightly on the higher side, each tool serves a distinct function and the count is justified for the domain.
The tool set provides full CRUD for campaigns and leads, plus analytics and import/export. A minor gap is the lack of a dedicated 'remove lead from campaign' tool, but the core workflows are well-covered.
LinkedIn outreach MCP server — 19 tools for AI agents to prospect, sequence, and manage contacts.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Run B2B outreach from your AI agent: 250+ tools for campaigns, leads, LinkedIn and email workflows.
MailBeast.ai is a cold email outreach platform. This server lets AI assistants create and launch campaigns with multi-step A/B sequences, manage leads and sending mailboxes (health, warmup, limits), read and answer replies from a unified inbox, and pull campaign analytics. OAuth 2.1 sign-in with read-only or read-and-write access; an API key header is also supported. Website: https://mailbeast.ai
