aem-mcp-server

AEM MCP Server (aem-mcp-server)

AEM MCP Server is a full-featured Model Context Protocol (MCP) server for Adobe Experience Manager (AEM). It provides a simple integration with any AI Agent. This project is designed for non-technical persons who want to manage AEM via natural language.

Overview

• Chat with your AEM instance for content, component, and asset operations.
• AI IDEs integration (Cursor, Copilot, Webstorm, VS Code, etc.)
• Supports both AEMaaCS and self-hosted instances
• Modern, TypeScript-based AEM MCP server
• REST/JSON-RPC API with latest MCP features.

Quick Start

Prerequisites

• Node.js 18+
• Access to an AEM instance (local or remote)

Installation

npm install aem-mcp-server -g

Start the Server

With default settings (admin:admin credentials for http://localhost:4502):

aem-mcp

Configuration

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]

For AEMaaCS, use the clientId and clientSecret for authentication. More info. For self-hosted AEM use user/pass. The default credentials are admin:admin.

Example Command

aem-mcp -u=[e-mail] -p=mypass -H=https://author-qa.domain.com

Add AEM MCP to AI IDE

Features

• AEM Page & Asset Management: Create, update, delete, activate, deactivate, and replicate pages and assets
• Component Operations: Validate, update, scan, and manage AEM components (including Experience Fragments)
• Advanced Search: QueryBuilder, fulltext, fuzzy, and enhanced page search
• Replication & Rollout: Publish/unpublish content, roll out changes to language copies
• Text & Image Extraction: Extract all text and images from pages, including fragments
• Template & Structure Discovery: List templates, analyze page/component structure
• JCR Node Access: Legacy and modern node/content access
• AI/LLM Integration: Natural language interface for AEM via OpenAI, Anthropic, Ollama, or custom LLMs
• Security: Auth, environment-based config, and safe operation defaults

AI IDE Integration (Cursor, Copilot, etc.)

AEM MCP Server is compatible with modern AI IDEs and code editors that support MCP protocol, such as Cursor and Copilot (eg in WebStorm or VS Code).

How to Connect:

• Install and run the AEM MCP Server as described above.

• Configure your IDE to connect to the MCP server:

  • Open your IDE's MCP server settings.
  • Add a new server with:
    • Type: Custom MCP
    • url: http://127.0.0.1:8502/mcp

• Restart your IDE if needed. The IDE will now be able to:

  • List, search, and manage AEM content
  • Run MCP methods (CRUD, search, rollout, etc.)

Sample for AI-based code editors or custom clients:

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

Usage

List all components on MyPage

API Documentation

For detailed API documentation, please refer to the API Docs.

Similar Projects

• https://github.com/indrasishbanerjee/aem-mcp-server (Used as a base for this project)
• https://www.npmjs.com/package/@myea/aem-mcp-handler (Looks like an original source of the above project)