smartlead-mcp-server-local MCP Server

Use This MCP server To

Integrate Smartlead email marketing with AI assistants Automate email campaign management via MCP clients Deploy Smartlead MCP server locally for development Connect Smartlead API to n8n workflows Enable real-time email marketing data access for AI tools Simplify Smartlead API usage in custom automation scripts

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):

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

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.

smartlead-mcp-server-local FAQ

How do I install the smartlead-mcp-server-local?

You can install it via npm using 'npm install smartlead-mcp-server@1.2.1' or run it directly with npx without installation.

Is a license key required to use smartlead-mcp-server-local?

No license key is required; all features are enabled by default with maximum permissiveness.

How do I provide my Smartlead API key to the server?

On first run, the server prompts you to enter your Smartlead API key, which it uses for authentication.

Can smartlead-mcp-server-local be used with automation tools like n8n?

Yes, it supports integration with n8n and other MCP-compatible clients for workflow automation.

Is smartlead-mcp-server-local open for community contributions?

Yes, the project welcomes community contributions and provides developer onboarding documentation.

How do I start the server with Claude integration?

Use the command 'npx smartlead-mcp-server start' to launch the server for Claude or similar clients.

Where can I find developer details for smartlead-mcp-server-local?

Developer details are available in the DEVELOPER_ONBOARDING.md file included in the repository.