Skip to main content
MCP server CX Codex

Alfresco MCP server for Claude Code: setup and how it works

This MCP server exposes Alfresco's REST API as tools an agent can call, so Claude Code and similar tools can read and manage documents directly.

no license updated 2026-10-29

Open on GitHub

What Alfresco does

The server wraps Alfresco's REST API as MCP tools and relies on authentication tickets rather than stored passwords. Getting a ticket is a separate step: you call Alfresco's authentication endpoint with a userId and password, grab the returned id value, and use it to talk to the server.

Three ways to run it: directly with Python (alfresco_mcp_server.py, stdio by default), through FastMCP with --transport http or --transport sse, or inside Docker by setting ALFRESCO_HOST, TRANSPORT_MODE and HTTP. A Docker Compose file and an MCP Inspector setup are included for local testing against a running instance.

It needs Python 3.11+ and a reachable Alfresco instance with REST API access; without a valid ticket the tools won't authenticate.

What it helps with

  • connect an agent to Alfresco documents and folders
  • script Alfresco REST API calls from a chat session
  • run an MCP server in Docker next to an Alfresco instance
  • fetch and use an Alfresco authentication ticket
  • switch between stdio, HTTP and SSE depending on the setup

Example prompts for the agent

  • List the documents in the root folder of Alfresco
  • Find a file by name in the Alfresco repository and show its metadata
  • Create a new folder in Alfresco through the REST API

How to install Alfresco

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Alfresco

How do I install the Alfresco MCP server?

Download the project, create a virtual environment (python3 -m venv .venv && source .venv/bin/activate), install dependencies with pip install -r requirements.txt, and set the ALFRESCO_HOST variable to point at your Alfresco instance.

What does the Alfresco MCP server do?

It turns Alfresco's REST API into a set of tools an agent can call, authenticating with tickets instead of storing a password in config.

What do I need to run the Alfresco MCP server?

You need Python 3.11+, an Alfresco instance with REST API access, and an authentication ticket obtained via a separate call to Alfresco before connecting the server.

Similar MCP servers

All MCP servers for Writing and docs →

Project sponsors

Companies that keep this analytics open