lemlist-mcp

Unofficial MCP server for the lemlist API — use lemlist from Claude, Cursor, and other AI tools.

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by lemlist.

Installation

npm install -g lemlist-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "lemlist": {
      "command": "npx",
      "args": ["-y", "lemlist-mcp"],
      "env": {
        "LEMLIST_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add lemlist -- npx -y lemlist-mcp

Then set your API key in your environment:

export LEMLIST_API_KEY=your-api-key

Cursor

Add to your MCP settings:

{
  "lemlist": {
    "command": "npx",
    "args": ["-y", "lemlist-mcp"],
    "env": {
      "LEMLIST_API_KEY": "your-api-key"
    }
  }
}

HTTP Mode

Run the server as a Streamable HTTP endpoint for remote MCP clients:

# Start on default port 3100
lemlist-mcp --http

# Custom port
lemlist-mcp --http --port 8080

# With Bearer token authentication
lemlist-mcp --http --token my-secret

Environment variable alternatives: PORT (default port), MCP_AUTH_TOKEN (auth token).

Available Tools

The MCP server exposes tools for:

• Campaigns — list, get, create, update, start, pause, stats, export
• Leads — add, update, delete, list, mark interested/not interested
• Contacts — list, get details
• Companies — list, get notes
• Enrichment — enrich leads and data, bulk enrichment
• People Database — search people and companies
• Inbox — conversations, drafts, labels, send messages
• Schedules — manage sending schedules
• Sequences — manage steps
• Tasks — list, create, update
• Team — info, credits, senders
• Unsubscribes — manage unsubscribe list
• Webhooks — add, list, delete
• Lemwarm — email warming settings

All tools include readOnlyHint, destructiveHint, and idempotentHint annotations.

License

MIT