How do I install Alfresco MCP Server?

Follow the setup instructions on the Alfresco GitHub repository, then add the server configuration to your AI client.

What category is Alfresco MCP Server?

Alfresco is categorized under APIs, Databases. Browse more servers in these categories on MCPgee.

Alfresco

Name: Python Alfresco MCP Server
Author: stevereiner

v1.0.0•APIs•stable

Python based MCP Server for Alfresco using python-alfresco-api and FastMCP 2.0

alfrescomcpmcp-serverpython

Stars

Downloads

Weekly

0/5

View on GitHub

What is Alfresco?

Alfresco is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to python based mcp server for alfresco using python-alfresco-api and fastmcp 2.0

Python based MCP Server for Alfresco using python-alfresco-api and FastMCP 2.0

This server falls under the APIs and Databases categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

Python based MCP Server for Alfresco using python-alfresco-a

Use Cases

Access Alfresco content management via Python API wrapper.

stevereiner

Maintainer

LicenseApache-2.0

Languagepython

Versionv1.0.0

UpdatedApr 10, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx python-alfresco

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use Alfresco

Python Alfresco MCP Server is a full-featured Python MCP server for Alfresco Content Services built with FastMCP 2.0, offering comprehensive content management and search capabilities through a natural language interface. It exposes tools for full-text search, advanced AFTS queries, CMIS SQL-like search, metadata search, document upload and download, check-in/check-out, folder creation and browsing, node deletion, and property management. Teams using Alfresco Community or Enterprise for enterprise content management can connect their AI assistant directly to the repository to search, manage, and organize documents conversationally.

Prerequisites

Python 3.10 or higher installed
A running Alfresco Content Services instance (Community or Enterprise), tested with the default admin credentials at http://localhost:8080
uv or uvx package manager recommended (pip also supported)
An MCP-compatible client such as Claude Desktop or Cursor

Install with uvx (recommended for users)

Use uvx to install and run python-alfresco-mcp-server from PyPI. uvx automatically handles isolated environments and global availability.

# Install UV/UVX first if needed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Test installation
uvx python-alfresco-mcp-server --help

Or install with pip

Install using standard pip. The python-alfresco-api dependency is installed automatically.

pip install python-alfresco-mcp-server

Configure Alfresco connection via environment variables

Set the four required environment variables pointing to your Alfresco instance. Create a .env file for cross-platform convenience.

# .env file
ALFRESCO_URL=http://localhost:8080
ALFRESCO_USERNAME=admin
ALFRESCO_PASSWORD=admin
ALFRESCO_VERIFY_SSL=false

Add the server to Claude Desktop configuration

Edit claude_desktop_config.json to register the server. When using uvx, the command is 'uvx' with the package name as the argument.

{
  "mcpServers": {
    "alfresco": {
      "command": "uvx",
      "args": ["python-alfresco-mcp-server"],
      "env": {
        "ALFRESCO_URL": "http://localhost:8080",
        "ALFRESCO_USERNAME": "admin",
        "ALFRESCO_PASSWORD": "admin",
        "ALFRESCO_VERIFY_SSL": "false"
      }
    }
  }
}

Restart Claude Desktop and test the connection

Restart Claude Desktop to activate the server. Ask Claude to retrieve the repository info or search for documents to confirm the connection works.

Alfresco Examples

Client configuration

Complete Claude Desktop configuration for the Alfresco MCP server using uvx with environment variable credentials.

{
  "mcpServers": {
    "alfresco": {
      "command": "uvx",
      "args": ["python-alfresco-mcp-server"],
      "env": {
        "ALFRESCO_URL": "http://localhost:8080",
        "ALFRESCO_USERNAME": "admin",
        "ALFRESCO_PASSWORD": "admin",
        "ALFRESCO_VERIFY_SSL": "false"
      }
    }
  }
}

Prompts to try

Example prompts for searching, managing, and organizing documents in Alfresco through the AI assistant.

- "Search Alfresco for all documents containing the word 'contract'"
- "List all files in the /Company Home/Sites/hr folder"
- "Upload the file at /Users/me/report.pdf to the /Company Home/Shared folder"
- "Check out the document with node ID abc-123 for editing"
- "Get the repository status and version information"
- "Find all documents modified in the last 7 days using advanced search"
- "Set the 'cm:description' property of document xyz to 'Q4 Annual Report'"

Troubleshooting Alfresco

Connection refused when reaching Alfresco at localhost:8080

Verify Alfresco is running with 'curl http://localhost:8080/alfresco/api/discovery'. If using Docker, ensure the port is mapped correctly. Check ALFRESCO_URL includes the full base URL without a trailing slash.

SSL certificate verification errors

Set ALFRESCO_VERIFY_SSL=false for development environments or self-signed certificates. For production, provide the path to your CA bundle: ALFRESCO_VERIFY_SSL=/path/to/ca-bundle.crt

python-alfresco-api version mismatch error at startup

python-alfresco-mcp-server v1.1 requires python-alfresco-api >= 1.1.1. Run 'pip install --upgrade python-alfresco-api' or 'uvx --reinstall python-alfresco-mcp-server' to get the compatible versions.

Frequently Asked Questions about Alfresco

What is Alfresco?

Alfresco is a Model Context Protocol (MCP) server that python based mcp server for alfresco using python-alfresco-api and fastmcp 2.0 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Alfresco?

Follow the installation instructions on the Alfresco GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Alfresco?

Alfresco works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Alfresco free to use?

Yes, Alfresco is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Alfresco Alternatives — Similar APIs Servers

Looking for alternatives to Alfresco? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.

Kong

★ 43.4k

🦍 The API and AI Gateway

API Mega List

★ 5.4k

This GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪

Fetch

★ 5.4k

Fetch web content and convert to markdown for AI consumption

Fusio

★ 2.1k

Self-Hosted API Management for Builders

Korean Law

★ 1.8k

국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools

RuleGo

★ 1.5k

⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

APIs Databases Browse All Servers

Set Up Alfresco in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "python-alfresco": {
      "command": "npx",
      "args": ["-y", "python-alfresco"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Alfresco?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides