# AEM Content Manager MCP server

> Allows AI agents to validate and execute Groovy scripts on Adobe Experience Manager instances via the ACM API.

- Repository: https://github.com/wttech/acm
- Page: https://hostedmcp.org/servers/wttech/acm-mcp-server
- Transport: stdio
- Stars: 37
- License: Apache-2.0
- Latest version: 0.1.4

## Install

### Claude Code

```sh
claude mcp add --env 'ACM_CONFIG_FILE=<ACM_CONFIG_FILE>' --env 'ACM_CONFIG=<YOUR_ACM_CONFIG>' acm-mcp-server -- npx -y @wppes/acm-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "acm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@wppes/acm-mcp-server"
      ],
      "env": {
        "ACM_CONFIG_FILE": "<ACM_CONFIG_FILE>",
        "ACM_CONFIG": "<YOUR_ACM_CONFIG>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "acm-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wppes/acm-mcp-server"
      ],
      "env": {
        "ACM_CONFIG_FILE": "<ACM_CONFIG_FILE>",
        "ACM_CONFIG": "<YOUR_ACM_CONFIG>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"acm-mcp-server","type":"stdio","command":"npx","args":["-y","@wppes/acm-mcp-server"],"env":{"ACM_CONFIG_FILE":"<ACM_CONFIG_FILE>","ACM_CONFIG":"<YOUR_ACM_CONFIG>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "acm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@wppes/acm-mcp-server"
      ],
      "env": {
        "ACM_CONFIG_FILE": "<ACM_CONFIG_FILE>",
        "ACM_CONFIG": "<YOUR_ACM_CONFIG>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add acm-mcp-server --env 'ACM_CONFIG_FILE=<ACM_CONFIG_FILE>' --env 'ACM_CONFIG=<YOUR_ACM_CONFIG>' -- npx -y @wppes/acm-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.acm-mcp-server]
command = "npx"
args = ["-y", "@wppes/acm-mcp-server"]

[mcp_servers.acm-mcp-server.env]
ACM_CONFIG_FILE = "<ACM_CONFIG_FILE>"
ACM_CONFIG = "<YOUR_ACM_CONFIG>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'ACM_CONFIG_FILE=<ACM_CONFIG_FILE>' -e 'ACM_CONFIG=<YOUR_ACM_CONFIG>' acm-mcp-server npx -- -y @wppes/acm-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "acm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@wppes/acm-mcp-server"
      ],
      "env": {
        "ACM_CONFIG_FILE": "<ACM_CONFIG_FILE>",
        "ACM_CONFIG": "<YOUR_ACM_CONFIG>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ACM_CONFIG_FILE` | yes | no | Path to the ACM config document: the acm.instances list (with per-instance authMode, secret, readonly, enabled), acm.activeInstance and timing keys, same keys as the VS Code extension settings |
| `ACM_CONFIG` | no | yes | The same config document inline instead of a file; takes precedence over ACM_CONFIG_FILE |

## Tools (11)

- `acm_list_instances`
- `acm_health`
- `acm_validate_code`
- `acm_run_code`
- `acm_get_execution`
- `acm_abort_execution`
- `acm_list_executions`
- `acm_list_scripts`
- `acm_get_script`
- `acm_describe_inputs`
- `acm_get_output_file`
