Joomla MCP

Name: Joomla MCP
Author: nasoma

@nasoma

About Joomla MCP

The Joomla MCP Server facilitates interaction between AI assistants (like Claude) and Joomla websites through the Joomla Web Services API. It provides tools to manage articles, including retrieving, creating, updating, and deleting content, as well as managing article states.

#joomla #mcp #ai-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Joomla Articles MCP": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}",
        "run",
        "main.py"
      ],
      "env": {
        "JOOMLA_BASE_URL": "<your_joomla_website_url>",
        "BEARER_TOKEN": "<your_joomla_api_token>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Joomla MCP?

Joomla MCP is a Model Context Protocol server that lets AI assistants like Claude interact with Joomla websites via the Joomla Web Services API, primarily to manage articles.

How to use Joomla MCP?

Install Python 3.11+, clone the repository, set up a virtual environment with uv, and configure the server in your AI assistant (e.g., Claude Desktop) by providing the Joomla base URL and a bearer token in environment variables.

Key features of Joomla MCP

Retrieve all articles from a Joomla website
List all content categories
Create new articles with optional plain-text-to-HTML conversion
Manage article states (published, unpublished, trashed, archived)
Delete articles
Update articles (requires both introtext and fulltext with a "Read more" break)

Use cases of Joomla MCP

Manage Joomla articles through conversational AI commands
Automate content creation and publishing workflows
Bulk update or delete articles without manual intervention
Integrate Joomla content management with AI-powered assistants

FAQ from Joomla MCP

What are the requirements for using Joomla MCP?

Python 3.11+, a Joomla 4.x or 5.x site with the Web Services API plugin enabled, and a valid API bearer token.

How do I obtain a Joomla API token?

Log in to the Joomla Administrator, go to Users > Manage, edit the Super User account, open the "Joomla API Token" tab, click Generate, and copy the token.

What tools does Joomla MCP provide?

Six tools: get_joomla_articles(), get_joomla_categories(), create_article(), manage_article_state(), delete_article(), and update_article().

How do I configure Joomla MCP for Claude Desktop?

Add an entry to claude_desktop_config.json with the path to uv, the project directory, and the environment variables JOOMLA_BASE_URL and BEARER_TOKEN.

Are there security considerations?

Treat the API token like a password, as it provides site access. The server sanitizes HTML to prevent XSS, and HTTPS should be used for API communications.