Uses environment variables through .env files for configuration of AEM connections, API keys, and server settings
Built on Node.js runtime (v18+) for server operations and AEM connectivity
Integrates with Ollama to provide local LLM capabilities for natural language AEM management
Connects to OpenAI's API to enable natural language processing for AEM content management tasks
Features a Telegram bot for conversational AEM management, allowing chat-based content and component operations
Built with TypeScript for type-safe development and modern JavaScript features
AEM MCP Server (aem-mcp-server)
AEM MCP Server is a full-featured, extensible Model Context Protocol (MCP) server for Adobe Experience Manager (AEM). It provides a robust REST/JSON-RPC API for content, component, and asset management, with advanced integrations for AI, chatbots, and automation. This project is designed for AEM developers, content teams, and automation engineers who want to manage AEM programmatically or via natural language.
Table of Contents
- Overview
- Features
- Quick Start
- Usage Examples
- Configuration
- API & Client Usage
- AI IDE Integration (Cursor, Cline, etc.)
- Security
- Project Structure
- Integrations
- Contribution
- License
Overview
- Modern, TypeScript-based AEM MCP server
- REST/JSON-RPC API for AEM content, component, and asset operations
- AI/LLM integration (OpenAI, Anthropic, Ollama, custom HTTP APIs)
- Telegram bot for conversational AEM management
- Production-ready, modular, and extensible
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
- Telegram Bot: Manage AEM via chat, including conversational commands
- Security: Auth, environment-based config, and safe operation defaults
Quick Start
Prerequisites
- Node.js 18+
- Access to an AEM instance (local or remote)
Installation
Build
Run (Production)
Run (Development, hot reload)
Usage Examples
1. List all pages under a path
2. Update a component property
3. Use with AI IDEs (Cursor, Cline, etc.)
- See the AI IDE Integration section below.
Configuration
Environment Variables
Create a .env
file in the project root with the following (edit as needed):
MCP Client Configuration
Sample for AI-based code editors or custom clients:
API & Client Usage
- REST/JSON-RPC: Exposes all AEM operations via HTTP endpoints
- Supported Operations: Page/asset CRUD, component validation/update, search, rollout, publish, text/image extraction, and more
- AI/LLM: Send natural language commands to the server (via API or Telegram)
- Telegram Bot: Connect your bot using
TELEGRAM_BOT_TOKEN
and chat with your AEM instance
AI IDE Integration (Cursor, Cline, etc.)
AEM MCP Server is compatible with modern AI IDEs and code editors that support MCP protocol, such as Cursor and Cline.
How to Connect:
- Install and run the AEM MCP Server as described above.
- Configure your IDE to connect to the MCP server. Example for Cursor/Cline:
- Open your IDE's MCP server settings.
- Add a new server with:
- Type: Custom MCP
- Command:
node
- Args:
["/absolute/path/to/dist/mcp-server.js"]
- Port:
8080
(or as configured) - Auth: Use
MCP_USERNAME
/MCP_PASSWORD
from your.env
- Restart your IDE and connect. The IDE will now be able to:
- List, search, and manage AEM content
- Run MCP methods (CRUD, search, rollout, etc.)
- Use AI/LLM features if enabled
Custom MCP Clients
- You can build your own MCP client in any language that supports HTTP/JSON-RPC.
- See the Usage Examples for API call patterns.
- Authenticate using basic auth (
MCP_USERNAME
/MCP_PASSWORD
). - All MCP methods are available via the
/api
endpoint.
Security
- Auth required for all operations (see
MCP_USERNAME
/MCP_PASSWORD
) - Environment-based configuration for safe deployment
- All destructive operations require explicit parameters and validation
Project Structure
src/
— TypeScript source codedist/
— Compiled JS output
Integrations
- AI/LLM: OpenAI, Anthropic, Ollama, custom HTTP APIs
- Telegram: Chat-based AEM management
Contribution
Contributions are welcome! Please open issues or pull requests for bug fixes, features, or documentation improvements.
License
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server for Adobe Experience Manager that provides REST/JSON-RPC APIs for content, component, and asset management with AI, chatbot, and automation integrations.
Related MCP Servers
- AsecurityAlicenseAqualityThis server implements the Model Context Protocol to facilitate meaningful interaction and understanding development between humans and AI through structured tools and progressive interaction patterns.Last updated -1322TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that facilitates communication between ABAP systems and MCP clients, providing tools for managing ABAP objects, handling transport requests, and performing code analysis to enhance ABAP development workflows.Last updated -1283TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for Adobe After Effects that enables AI assistants and other applications to control After Effects through a standardized protocol.Last updated -1361JavaScriptMIT License
- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -35TypeScriptMIT License