Claude Desktop Setup

Add the Listmonk MCP server to Claude Desktop.

Configuration

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add the server configuration:

{
  "mcpServers": {
    "listmonk": {
      "command": "uvx",
      "args": ["listmonk-mcp"],
      "env": {
        "LISTMONK_MCP_URL": "http://localhost:9000",
        "LISTMONK_MCP_USERNAME": "your-api-username",
        "LISTMONK_MCP_PASSWORD": "your-api-token"
      }
    }
  }
}

Environment Variables

• LISTMONK_MCP_URL: Your Listmonk server URL
• LISTMONK_MCP_USERNAME: API user created in Admin → Users
• LISTMONK_MCP_PASSWORD: API token (not user password)

Prerequisites

1. Install uvx (if not already installed):

   pip install uv
   

2. Create API user and token in Listmonk admin interface:

3. Go to Admin → Users in your Listmonk instance

4. Create a new API user and token

5. Restart Claude Desktop after adding configuration