home / mcp / aem mcp server

AEM MCP Server

Provides an MCP server for AEM to manage content, components, and assets via natural language and AI-assisted workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "easingthemes-aem-mcp-server": {
      "url": "http://127.0.0.1:8502/mcp"
    }
  }
}

You can manage Adobe Experience Manager (AEM) using natural language with a full-featured MCP server. This server exposes a modern API surface, supports AI-assisted workflows, and works with both AEMaaCS and self-hosted instances to help you create, update, and organize content, components, and assets through intuitive commands.

How to use

You connect an MCP client or AI IDE to the MCP server to perform content, component, and asset operations through natural language. Start by running the MCP server locally or on your preferred host, then configure your client to talk to the server’s MCP endpoint. Use conversational prompts to create pages, manage assets, validate components, and perform searches or rollouts across language copies. The server supports integration with AI IDEs, enabling you to issue MCP methods through familiar development environments. When you are ready, you can operate on AEM content by asking the assistant to list pages, create assets, or publish changes, all routed through the MCP server.

How to install

Prerequisites You need Node.js 18 or newer and access to an AEM instance (local or remote). Ensure you have network access to your AEM instance and the required permissions to manage content.

npm install aem-mcp-server -g

Start the MCP server using default settings. The default assumes you connect to AEM at http://localhost:4502 with admin/admin credentials.

aem-mcp

Optional configuration shows the available command-line options. You can customize host, credentials, client id/secret, and the MCP port used for the server.

Options:
      --version  Show version number                                   [boolean]
  -H, --host                         [string] [default: "http://localhost:4502"]
  -u, --user                                         [string] [default: "admin"]
  -p, --pass                                         [string] [default: "admin"]
  -i, --id       clientId                                 [string] [default: ""]
  -s, --secret   clientSecret                             [string] [default: ""]
  -m, --mcpPort                                         [number] [default: 8502]
  -h, --help     Show help                                             [boolean]

Example for a custom AEM host and credentials shows how you can pass user, password, and host details.

aem-mcp [email protected] -p=mypass -H=https://author-qa.domain.com

Additional steps and notes

AI IDE integration is supported, enabling you to connect Cursor, Copilot, WebStorm, VS Code, and similar editors to the MCP server for direct content operations and MCP method execution.

For IDE connection, you typically configure a new MCP server with the URL for the MCP endpoint. A common local setup uses the endpoint http://127.0.0.1:8502/mcp.

{
  "mcpServers": {
    "AEM": {
      "url": "http://127.0.0.1:8502/mcp"
    }
  }
}

Security and access

Authentication can use AEM user credentials for self-hosted instances or client credentials for AEMaaCS. Ensure you configure credentials securely and apply environment-based configuration for safer operation.

Notes

The MCP server provides a REST/JSON-RPC API with up-to-date MCP features to facilitate content, component, and asset management via natural language or programmatic calls.