Skip to main content
Glama

AEM 6.5 MCP Server

Standalone Node.js Model Context Protocol server for Adobe Experience Manager 6.5 Author. It does not install anything on AEM.

Status: pre-production. Use the capability matrix as the list of supported operations. Release gates are in docs/adr/0001-standalone-http-mcp.md.

Node.js AEM License: AGPL-3.0

This project is AGPL-3.0 for open source use. Commercial licensing is described in COMMERCIAL_LICENSE.md.

AEMaaCS is a different product: see aemaacs-mcp-server. AEM 6.5 LTS is out of scope.

What this is

  • MCP stdio for IDE clients (primary).

  • Optional MCP Streamable HTTP (POST /mcp) with API key or HTTP Basic. OAuth is out of scope.

  • One typed tool catalog driving both transports.

  • Documented AEM 6.5 HTTP only: Granite CSRF, /bin/wcmcommand, /bin/replicate.json, QueryBuilder, Assets createasset.html, Workflow REST.

Related MCP server: SupaUI MCP Server

What this is not

  • Production-ready until CI gates and live Author contract tests pass.

  • An AEM package, OSGi service, or RepoInit installer.

  • Atomic bulk rollback, JCR-SQL2, MSM rollout, tree activation, or .infinity.json dumps.

  • An OpenAI/Anthropic/Telegram bot.

Requirements

  • Node.js 20 or 22

  • AEM 6.5 Author SP17+ reachable over HTTP(S)

  • A technical user that already exists in AEM User Admin (ACL checklist)

Quick start (stdio)

cp .env.example .env
# set AEM_HOST, AEM_SERVICE_USER, AEM_SERVICE_PASSWORD
npm ci
npm run build
npm run mcp

Cursor / Claude desktop config:

{
  "mcpServers": {
    "aem-65": {
      "command": "node",
      "args": ["/absolute/path/to/dist/mcp/stdio.js"],
      "env": {
        "AEM_HOST": "http://localhost:4502",
        "AEM_SERVICE_USER": "mcp-technical",
        "AEM_SERVICE_PASSWORD": "<secret>"
      }
    }
  }
}

Optional HTTP gateway

export MCP_API_KEY=replace-me
export HTTP_ENABLED=true
npm start
  • Liveness (no auth): GET /health/live

  • Readiness (auth): GET /health/ready

  • MCP: POST /mcp (SDK Streamable HTTP)

  • Convenience REST: GET /api/methods, POST /api/methods/:name (same auth; not a substitute for MCP)

Put TLS in front. Bind HOST=127.0.0.1. Set ALLOWED_HOSTS and CORS_ORIGINS.

curl -sS -H "X-API-Key: $MCP_API_KEY" http://127.0.0.1:3001/api/methods

Configuration

See .env.example. Required: AEM_HOST, AEM_SERVICE_USER, AEM_SERVICE_PASSWORD. Production/staging refuse admin/admin and refuse HTTP without API key or Basic.

Default page resource type is core/wcm/components/page/v3/page. Override with AEM_DEFAULT_PAGE_RESOURCE_TYPE and AEM_DEFAULT_CONTAINER for your project.

Architecture

MCP client → stdio or Streamable HTTP → typed tool catalog
  → validation / path policy / audit → AEM 6.5 HTTP adapter → Author

Details: capability matrix, tool reference, operations, threat model, 1.x migration.

Development

npm ci
npm run lint
npm test
npm run build

Live Author tests (optional): AEM_INTEGRATION=1 npm test.

License

AGPL-3.0-or-later. Contact via LinkedIn for commercial licensing.

Available Tools

48 tools
activatePageC

Activate (publish) a single page

Inputs: pagePath (required), activateTree.

bulkUpdateComponentsA

Update multiple components in a single operation with validation and rollback support

Inputs: updates (required), validateFirst, continueOnError.

cancelWorkflowC

Cancel a workflow instance

Inputs: workflowId (required), reason.

compareVersionsC

Compare two versions of content

Inputs: path (required), version1 (required), version2 (required).

completeWorkflowStepD

Complete a workflow step

Inputs: workflowId (required), stepName (required), comment.

createComponentC

Create a new component on a page

Inputs: pagePath (required), componentType (required), resourceType (required), properties, +1 more.

createPageC

Create a new page in AEM

Inputs: parentPath (required), title (required), template (required), name, +1 more.

createVersionC

Create a new version of content

Inputs: path (required), label, comment.

deactivatePageC

Deactivate (unpublish) a single page

Inputs: pagePath (required), deactivateTree.

deleteAssetC

Delete an asset from AEM DAM

Inputs: assetPath (required), force.

deleteComponentC

Delete a component from AEM

Inputs: componentPath (required), force.

deletePageC

Delete a page from AEM

Inputs: pagePath (required), force.

deleteVersionD

Delete a specific version

Inputs: path (required), versionName (required).

enhancedPageSearchC

Intelligent page search with comprehensive fallback strategies and cross-section search

Inputs: searchTerm (required), basePath (required), includeAlternateLocales.

executeJCRQueryD

Execute JCR query

Inputs: query (required), limit.

fetchAvailableLocalesC

Get available locales for a site and language master

Inputs: site (required), languageMasterPath (required).

fetchLanguageMastersC

Get language masters for a specific site

Inputs: site (required).

fetchSitesB

Get all available sites in AEM

Inputs: no named parameters.

getAllTextContentC

Get all text content from a page including titles, text components, and descriptions

Inputs: pagePath (required).

getAssetMetadataD

Get asset metadata

Inputs: assetPath (required).

getNodeContentD

Legacy: Get JCR node content

Inputs: path (required), depth.

getPageContentC

Get all content from a page including Experience Fragments and Content Fragments

Inputs: pagePath (required).

getPageImagesC

Get all images from a page, including those within Experience Fragments

Inputs: pagePath (required).

getPagePropertiesD

Get page properties

Inputs: pagePath (required).

getPageTextContentC

Get text content from a specific page

Inputs: pagePath (required).

getStatusC

Get workflow status by ID

Inputs: workflowId (required).

getTemplatesC

Get available page templates

Inputs: sitePath.

getTemplateStructureC

Get detailed structure of a specific template

Inputs: templatePath (required).

getVersionHistoryC

Get version history for a content path

Inputs: path (required).

getWorkflowModelsB

Get all available workflow models

Inputs: no named parameters.

listActiveWorkflowsC

List all currently running workflow instances

Inputs: limit.

listChildrenD

Legacy: List child nodes

Inputs: path (required).

listMethodsB

Get list of available MCP methods

Inputs: no named parameters.

listPagesC

List all pages under a site root

Inputs: siteRoot, depth, limit.

replicateAndPublishC

Replicate and publish content to selected locales

Inputs: selectedLocales (required), componentData (required), localizedOverrides.

restoreVersionC

Restore content to a specific version

Inputs: path (required), versionName (required).

resumeWorkflowB

Resume a suspended workflow instance

Inputs: workflowId (required).

scanPageComponentsC

Scan a page to discover all components and their properties

Inputs: pagePath (required).

searchContentC

Search content using Query Builder

Inputs: type, fulltext, path, limit.

startWorkflowC

Start a new workflow instance

Inputs: model (required), payloadPath (required), title, comment.

suspendWorkflowC

Suspend a workflow instance

Inputs: workflowId (required), reason.

undoChangesC

Undo the last component changes

Inputs: jobId (required).

unpublishContentC

Unpublish content from the publish environment

Inputs: contentPaths (required), unpublishTree.

updateAssetC

Update an existing asset in AEM DAM

Inputs: assetPath (required), metadata, fileContent, mimeType.

updateComponentC

Update component properties in AEM

Inputs: componentPath (required), properties (required).

updateImagePathC

Update the image path for an image component and verify the update

Inputs: componentPath (required), newImagePath (required).

uploadAssetC

Upload a new asset to AEM DAM

Inputs: parentPath (required), fileName (required), fileContent (required), mimeType, +1 more.

validateComponentC

Validate component changes before applying them

Inputs: locale (required), pagePath (required), component (required), props (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 48 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific AEM operations like page management, asset handling, workflow control, and versioning. However, some overlap exists between 'getPageContent' and 'getAllTextContent'/'getPageTextContent', and between 'listPages' and 'enhancedPageSearch', which could cause minor confusion for agents.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern throughout (e.g., 'activatePage', 'createComponent', 'getAssetMetadata'), with clear action-object pairs. Minor deviations like 'enhancedPageSearch' (adjective-verb-noun) and 'listMethods' (which doesn't fit the AEM domain) slightly break the pattern but overall maintain good readability.

    Tool Count2/5

    With 48 tools, the count is excessive for typical MCP server scope, likely overwhelming for agents and increasing complexity. While AEM is a complex system, this many tools suggests poor scoping or fragmentation, as many operations could be consolidated into fewer, more general tools.

    Completeness5/5

    The tool set provides comprehensive coverage for AEM content management, including full CRUD operations for pages, components, assets, and versions, plus workflow management, search, and validation. No obvious gaps exist; agents can perform end-to-end tasks without dead ends in this domain.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers