Windsurf & Cursor Setup

Add the Listmonk MCP server to Windsurf or Cursor IDEs.

Windsurf Configuration

Add to your Windsurf MCP settings:

{
  "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"
      }
    }
  }
}

Cursor Configuration

Add to your Cursor MCP settings:

{
  "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:

   • Go to Admin → Users in your Listmonk instance
   • Create a new API user and token

3. Restart your IDE after adding configuration