Smartlead Simplified MCP Server

by jean-technologies

17 stars
902 downloads
Not rated
GitHub

About

Manage Smartlead campaigns, including creation, updates, and sequence management, using the Smartlead API.

Details

Author
jean-technologies
GitHub stars
17
Downloads
902
Categories
Communication, Other, Automation

- Campaign and lead management
- Statistics and analytics
- Smart delivery and webhooks
- n8n integration
- Client management and smart senders
- Download tracking and analytics
- All features enabled by default, no license key needed

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Smartlead Simplified MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm (npm install smartlead-mcp-server@1.2.1) or run directly with npx (npx smartlead-mcp-server start for Claude, npx smartlead-mcp-server sse for n8n). The first run prompts for a Smartlead API key; no license key is required. Configuration can also be done via the config command or the --api-key option.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "smartlead simplified mcp server": {
            "smartlead-mcp-server-local": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@jean-technologies/smartlead-mcp-server-local",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "smartlead-mcp-server-local": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@jean-technologies/smartlead-mcp-server-local",
            "--client",
            "claude"
        ]
    }
}

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?

- 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

License

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.