claude-desktop.md•1.16 kB
# 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:
```json
{
"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):
```bash
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 Claude Desktop** after adding configuration
